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SUBJECT J U££AUEi2«£Si3QmyE£S-.MQI£BaQK-.fiQCLiiB£MIMIQH 

The 8ui)d J update of the Integration Procedures Notebook 
is now avail able* Copies of this document may be obtained via 
the following command sequence! 

ATTACH, IP NDOC/UN*DE VI 
SES. PRINT IPNDOC 

Change pages are not being distributed for this level (as 
has been suggested) due to the fact that the volume of change 
pages is only sligtly smaller than the document itself* Some 
highlights of this revision are as follows? 

- Section 1 has been reduced in size as the information in 
this section was either inaccurate or out of date* 

- Several procedure updates have been documented in Section 
Zf and Section 3 has been corrected or clarification added 
where necessary* 

- The current Regression tests and test sequence has been 
documented in Section 4* The source of the tests as they are 
actually run has been replicated here* and the test sequence 
is exactly that used by the Integration project at this 
1 eve I* 

- The NOS/VE Transmittal Form has been changed to provide 
more information to the analyst transmitting code* 

- The latest version of the S2 Machine Usage Document Cor 
"Helpful Hints**) has been picked up as Appendix E* 
Information in this document takes precedence over that in 
Appendix F as it is more up to date* 

Appendix F has been reduced in size considerably* as 
redundant and inaccurate information has been deleted* The 
information in this Appendix still reflects much of the HCS 
syntax and conventions* some of which are still valid for 
NOS/VE at this level* 
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1.0.2 STANDARDS 

In order to facilitate the Installation process* certain 
standards wi I I have to be set and adhered to by at 1 members of 
the Operating System and Product Set. These standards Cto be 
defined in the Systems Interface Standard) will cover the 
following items* 

a) All program libraries will have the same format* this 
will be defined by (TBD)* 

b) All output tapes will conform to some predetermined 
format in terms of numbers of files and what each file 
will contain. This will be defined by (TBD). 

c) The above formats are intended to facilitate 
establishment of procedural ized installation decks. 
This implies that some convenient naming conventions 
must be observed* These conventions will be defined 
by CTBD). 



2-1 

ADVANCED SYSTEMS INTEGRATION PROCEDURES NOTEBOOK 

09/17/80 

mm -am -mm www^wiv mr***0m&miwm*m***m*+*09*im***i0*rm09t* 0*4*9 «r *wav *v mt4w *» -«r *r ** •*» «r *» at mi 0* ** ** 0* ** ** 00 &msmnm 0m 00 00 00 00 mm mi 000m 004m 1 

2,0 NOS/VE OPERATING SYSTEM BUILDS (CI) 
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2.0,1 INTRODUCTION 

The command language procedures corresponding to NOS/VE 
builds all reside in the INT1* INT2* or DEVI catalogs 
depending upon the desired level of verification the system 
has attained. It is assumed that the DEVI level of 
verification is the minimum level of system verification 
required by most users* therefore the DEVI catalog is 
frequently referenced in the remainder of this section* (A 
description of the catalog management policies employed for 
NOS/VE follows*) To obtain a listing of the complete set of 
command language procedures provided in the Integration 
catalog* execute the following command language sequences 

ACQUIRE*PROCLIB/UN«<Integration_Cataiog> 
SES. PRINT PROCLIB 

Before running the build procedures as batch jobs* a check 
must be made to insure that the user number under which the 
job Mill run has sufficient validation limits for the job to 
execute. The minimum values for certain limits must be as 

foil ON S * 

CM = 2437B 

NE * unl imited 

MS * unlimited 

DS * 4096 

EC ■ 2008 (if simulator is to use LCM) 

DB * unlimited Ceach library is built via batch job) 

The current values may be obtained with the LIMITS control 
card. If they are not large enough* have the operations staff 
change them. 



2.0.2 CATALOG MANAGEMENT POLICIES 

The catalog management function done by the Integration 
project approximates the cycle concept of permanent file 
management. New system files begin in the INT1 catalog and 
move to the INT2 and DEVI catalogs zs some significant 
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verification milestone has been achieved. Each catalog is 
intended to be self-contained* in that procedures executed 
from either catalog will access only those files which have 
the same level of verification associated with them* The INT1 
catalog will access the most recent compilers* Si:S tools* 
etc* while the INT2 catalog only contains selected system 
files from the last "stable" interim build which wilt 
deadstart and run a minimum set of test cases* The DEVI 
catalog represents the "frozen" catalog for which changes are 
no longer being accepted Ithis is typically a snapshot of the 
last build cycle)* The DEVI catalog will change no more 
frequently than once for each build cycle. The INT2 catalog 
will change only as frequently as bug fixes or system upgrades 
demand* with the objective of keeping this catalog no more 
than one week out of synchronization with the INTi catalog* 
The INTI catalog* however* is a "working catalog" for the 
debug of new system fixes* new procedures* etc* The stability 
of this catalog cannot be predicted* 



2.1 iflii&££J!AlMI£l!All££-£&fl££iiil&ES 

This section is being replaced by a user's guide which is 
targeted for inclusion as one of the appendices to this 
document. The procedures being developed are based upon the 
prototype Source Code Utility which is being made available In 
SES Release 14. 
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2*2.1 INTRODUCTION 



The basic version of NOS/VE consists of 5 base object files 
(XLMMTR, XLJ11F, XLJ12F, XLJ13F, XLJ1FF), the CYBIL runtime 
routine library fCYBILIB)* and several user program 
libraries* The general scheme used in modifying or replacing 
existing modules and adding new modules is to apply the 
changes to the appropriate base object text file and save this 
modified file in the current catalog* The checkpoint file 
build procedure NOSLINK will always attempt to obtain updated 
object text files from the current user's catalog before it 
attempts to get them from the Integration catalog* thereby 
allowing a user to replace these object text files with his 
own* The "quick link" option of NOSLINK cannot be used when 
modifying the base object text files as it does not use these 
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directly* but rather a pre-*! inked form of these files* 
2.2*2 NOS/VE PARTITIONING 



The system can be thought of as being partitioned into two 
sections consisting of the five object files mentioned 
previously. Each partition has associated with it certain 
protection* privilege and responsibility. The first partition 
consists of those routines that run in monitor mode and is 
known as the monitor. The second partition consists of those 
routines that run in job mode and is known as task services. 
The modules on file XLMMTR make up the monitor* and the 
modules on files XLJ11F, XLJ12F* XU13F and XLJ1FF make up 
task services. A single user task can perhaps be thought of 
as a third type of partition* 

Any XDCL'd symbol within a given partition can be XR£F*d by 
any module within the same partition. To allow other 
partitions to XREF these same symbols* the symbols must be 
gated. Gating a symbol only makes the symbol available to 
other partitions during the linking process* It does not 
necessarily mean that the XDCt f d location can actually be 
referenced - that is controlled by the ring brackets. In 
general* only selected XDCl'd symbols are gated. Refer to the 
MAP_offset_K file for a list of the entry points available to 
a user task. This list of entry points preceeds the linkage 
of user tasks and is entitled "INBOARD SYMBOL TABLE ENTRY 
POINTS FROM FILE i STSXOST". It should also be noted that a 
similar list exists for the Monitor entry points available to 
Task Services and is entitled similarly with the substitution 
of MTRXOST for STSXOST in the above title. 

2.2.2.1 ILBME 

The packed object text file XLMMTR contains all modules 
which run in monitor mode. Modules from this file execute in 
ring 1 of monitor and have a ring bracket of (1*1*1). They 
also execute with global privilege. 

The following modules reside in monitors 



CPMTR 

SYSTEM_MONITOR 

SIGNAL_M0NIT0R 

CPERR 

MMM$MEMORY_MANAGER_MONITOR_MODE 

CrP$COMMQN_INPUT_OUTPUT 
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FAP$FILE_ALLGCATIGN_MANAG£R 

SQP$SEQU£NC£_MANAG£R 

CMSCONF IGURATIQN_MANAG£R 

CPMC8 

KPPROC 

TMM$MTR_FLAG_S I GNAL_F UNCTIONS 

M£MGRY_LINK_MONITGR_MGD£ 

MMMASM 

GSAINX 

TMMSDISPATCHER 

MTM$SERVICE_ROUTINES 

MSM$MCU_REQUEST_PR0CE5S0R 

2.2.2.2 IL111E 

The packed object text file XLJ11F contains all nodules 
which run in ring 1 task services. Modules from this file 
execute in ring 1 and have a ring bracket of C1»1#F). 

The following modules reside in ring 1 task services* 



MISC_SERVICES_RING_1 

MEMQRY_MANAG£R 

SYSTEM_R0UTIN€_J0B_MQDE 

C0NS0LE_DISPLAY_MANAGER 

FILE_MANAGER 

MDUST 

DMP$SYSTEM_ INITIALIZATION 

J0B_DEADSTART 

QUEUED.FILE. MODULE 

INITIALIZE.MEMORY.LINK 

MEMQRY_LINK_INT£RFACE 

KPPROC 

OFM$B_DXSPLAY_MANAGER 

TMM$DISP0SE_GF_RING1_PR££MPTS 

MLP$C170_HELP€R 

TMM$MANAGE_SIGNALS 

OSM$INITIALIZE_TABLES 

MMM$SEGMENT_SIGNAL_HANDLER 

QUEU£_FILE_ INTERN AL_INTERF ACES 

STM$M0DIFY_AST_R1 

STM$R£AD_AST_R1 

DMM$KEEP_MVT 

DMM$R1_MOOIFY_MVT 
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2.2.2.3 1L112£ 

The packed object text file XLil2F contains all modules 
which run In ring 2 task services. Modules from this file 
execute in ring 2 and have a ring bracket of <1*2#F>. 

The following modules reside in ring 2 task services* 



JBTBLS 

DMP$JGB_INXT 

SEGMENT^MANAGER 

PR0GRAM_L0ADER 

SIGNAL_HANDLING_RGUTINES 

TASK.MANAGER 

EX£CUTE_PROCESSOR 

LGM$LOCAL_LOG_MANAGER 

TM2_CGMMAND_INTERFACE 

LOGICAL^NAME^SPACE^MANAGER 

TMM$ALLOCAT£_EXECUTION_RINGS 

TMM$DISP0SE_aF_RING2_PREEMPTS 

TMM$GET_MQNITQR_FAULT 

TMM$MANAGE_PRE£MPTIV£_8UFFERS 

408_INITIAT0R 

JOB.MONITQR 

JOBJTERMINATOR 

JM_PR0C_R2 

CLM$R£AD_INPUT_FIL£ 

LUM$SAVE_L I NK_US€R_ DESCRIPTOR 

MLMDDS 

TMM$CLEAR_VI A I ^INHIBITED 

PMM$DEFAULT_L0ADER_PARAM_MGMT_2 

FMM$LOCAL_NAM€_TABLE_MANAG£R 

FMMSTABLES 

INTER AC TIVE.USER 

IIM$REPORT_UNHANDL€D DATA MSG 

IIM$TIME_WAIT 

IIM$REPORT_UNHANDLED_SUPER_MSG 

IIM$R£PORT_STATUS_£RROR 

IIM$R£PORT_LaGICAL_ERROR 

IIM$ASCII_170_TQ_HEX 

STM$M0DIFY_VST_R2 

STM$READ_VST_R2 

STM$MODIFY_JOB_ASSOC_CAT 

STMSREAD^JOB^ASSOC.CAT 

STM$MODIFY_JOB_SET_TABLE 

STM$READ_JQB_S€T_TABL£ 

STM$SET_END_JOB 

STM$GET_MOD 

STM$RING2_CREATE_S£T 
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STM$RING2 - .PURG£_S£T 

STM$RING2_ADD_M£MBER 

STM$RING2_R£M0V£_MEMBER 

DMM$TEMPORARY_NGN_SET.j;ODE 

PFM$R2_REQUEST_PR0CESSGR 

PFA$CATALaG_SEGM£NT_D£FINITION 

2.2, 2, 4 *Lil3E 

The packed object text file XLJ13F contains all task 
service modules which run in ring 3 task services* Modules 
from this file execute in ring 3 and have a ring bracket of 
<1#3,F)„ 

The following modules reside in ring 3 task services* 

BAM$GPEN 

8UFFER_MANAG£R 

HPP$HEAP_MANAGER 

BAM$RECORD_MANAGER 

BAM$BLOCK_MANAGER 

BAM$SEGM£NT_POINT£R 

BAM$FILE_5TRUCTURE_FUNCTI0NS 

BAM$FETCH_TABL£ 

PMM$MANAGE_CONDITION_STACKS 

PMM$PRQGRAM_CONTRQL_S£R VICES 

TMM$DISP0S£_aF_RING3_PR€£MPTS 

TMM$DISPOSE_PREEMPTIVE_COMMG 

TMM$MGNITOR_FAULT_HANDLERS 

LOM$LOADER_EXECUTIVE 

L0M$L0AD_LI8RARY_M0DULES 

LOM$LIBRARY_LIST_MANAGEMENT 

LOM$LGAD_M A REGENERATION 

LOMSMODULE. LOADER 

LOM$£NTRY_EXT£RNAL_MATCHING 

LOM$TEXT_GENE RATION 

LOMSLINKAGE.GENERATIGN 

LQM$LINKAG£_NAME_TREE_MGMT 

LOM$PROGRAM_SEGMENT_MANAGEMENT 

LOM$DYNAMIC_TABLE_MANAG€M£NT 

LOM$PROGRAM_LGAD_LIEUTENANTS 

PMM$KLUDGE_LaADER_iF 

DATA_PROFILE 

GET_DATA_PROFILE 

LGM$LOADER_STUBS 

LGM$TASK_S£RVICES_DEF .MATCHING 

LOM$CROSS_REF£RENCE_MANAGEMENT 

CLM$MANAGE_STND_INP 

PMM$INTERFACE_TO_LOGGING 
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RHM$INTERIM_SIMULATED_IO 

RHM$SIMULATED_REPLAC€ 

RHM$SIMULAT£D_GET 

LUM$M AN AGE_L I NK„_USER._ INTERFACE 

CLM$CGMMAND_LIST_MANAGER 

CLM$REHGV£_ VARIABLE 

CLM$WRITE_VARIABLE 

PMM$DE8UG_STACK_MANAG£RS_13F 

PMM$DEBUG_TABLE_BUILDER 

PMM $D€F AULT_LOADER_PARAM_MGMT 

CLmBLOCK_STACK_MANAG£R 

CLMSDECL ARE. VARIABLE 

CLM$READ_VARIABLE 

CLHSINPUT STACK MANAGER 

DEBUG_SYSTEM_LEVEL_OECUTI0N 

JMM$PROGRAM_LEVEL_INTERFACES 

QUEU£_FILE_PRGGRAH_INTERFACES 

CLM$PR0CE5S_AS$IGNMENT 

PMM$MANAGE_LOCAL_QUEUES 

AMM$STQRE_FAP_POINTER 

JMQF_TEMPORARY_MOOULE 

BAMSCLOSE 

BAMSCONTROL 

BAM$FETCH_ART_TA8LE_P0INT€R 

BAM$PAD_RECORD 

BAM$REWIND 

BAM$STORE_ART_TABLE_POINTER 

RMM$REQUEST_T£RMINAL 

IIM$TASK_PRIVATE_DATA 

8AM$S£EK_DIRECT 

AMM$STORE_PROC£DURE_POINTER 

STMSCREATE.SET 

STM$PURGE_S£T 

STMSASSOCIATE^CATALOG 

STM$MI5C_SERVICE_R0UTINES 

STM$ADD_MEMBER 

STM$CHANGE_ACCESS_TO_SET 

STM$SIMULATED_REST_OF WORLD 

STM$REMGVE_MEMBER 

DMM$MAKE_VGLUM£ 

PFM$PROGRAM_INT£RFACE_PROCESS0R 

PFM$PARAMETER_CH£CKING 

PFM$PARAMETER_CONVERSION 

2,2.2,5 IL11££ 

The packed object text file XLJ1FF contains all modules 
which run in the ring of the caller. Modules from this file 
haye a ring bracket of (1»F>F), 
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The following modules reside in the any ring task services: 



MCPJTP 

OCALL 

SRMSCONVERSION.SERVICE.MANAGER 

MISC.SERVICES.ANY RING 

CMD.PROCESSOR.UTILITIES 

COMMAND.INTERFACE 

FILE.MGR.CQMMANDS 

DEBUG.USER.LEVEL. EXECUTION 

PMMSRUNANYWHERE.PRG.SERVICES 

MEMORY.MANAGER.REQUEST.PROCS 

CPMCB 

PFM SINTER I M.COMMAND.PROCESSOR 

AMM$FILE.STRUCTURE_FUNCTIONS 

PMMSCGNDITION.STACK. PROCESSOR 

PMMSDISPOSE.GF.CGNDITIQNS 

PMM$D ISPOSE.OF.TR APS 

TMMSDISPOSE.OF.MONITOR.FAULT 

CLM$ANALYZE_T0KEN 

CLMSANALYZE.VALUE 

CLMSSCAN.EXPRESSION 

CLM$C0NVERT.INTEGER_T0_STRING 

CLMSLEXICAL.PROCESSORS 

CLM$CONV£RT.VALUE_TG.STRING 

0SM$F0RMAT.MESSAGE 

0SM SSET.ST A TUS. ABNORMAL 

OS M$TR ANSI ATIQN_T ABLE S 

0SAINX 

MMMSSEGMENT.FAULT.HANDLER 

CLM$ACCEPT 

CLMSCOLLECT.TEXT.COMMAND 

CLMSINCLUDE 

CLM$PR0CESS.C0MMANDS 

CLMSSCAN.PARAMETER LIST 

CLMSSET.OBJECT.LIST 

CLMSSET.PROGRAM.OPTIONS 

0SM$L0CK.MANAGER 

MAINT.COMMANDS 

0SM$GENERATE_MESSAGE 

CLM$D I SPLAY. VALUE. COMMAND 

CLM$ACCESS.BL0CK.STACK 

CLM$ACC ESS. PARAMETERS 

CLM$FILE.REFERENCE. MANAGER 

CLMSCONVERT.STATUS 

PMM$DEBUG.STACK.MANAGERS.1FF 

PMMSPROGRAM.SER VICES 

PMMSSYSTEM.TIME.DECLARATIONS 
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PMM$STATUS_QUEUES_DEFINED 

REC_NGR_COMHANDS 

AMH$ADVANC£D_ACCESS_METHODS 

AMM$CLOS€ 

AMM$FETCH.ACCESS_INFORMATION 

AMNSFETCH 

AMMSFLUSH 

AMM$GET_N£XT 

AMM$GET_SEGMENT_POINTER 

AMMSGPEN 

AMM$PUT_PARTIAL 

AMM$PUT_N£XT 

AMM$REw"IND 

AMM$SKIP 

ANMSSETJSEGMENTJEOI 

AMHSSTQRE 

AMN$CHECK_RECQRD 

AMM$DELETE_KEY 

AMM$GETJ<EY 

AMN$GET_NEXT_K€Y 

AMMSPUT.KEY 

AMMSPUTREP 

AMM$REPLACE_KEY 

AMMSSTART 

ANMSSET.SEGMENT.POSITIQN 

AMM$GET_PARTIAL 

AMM$SEEK_DIR€CT 

AMM$GET_DIR£CT 

AMM$PUT_DIRECT 

AMM$GET_PARTIAl_DIRECT 

AMM$PUT_PARTIAt_DIR£CT 

CLM$P£RMANENT_FILE_COMMANDS 

CLM$DE8UG_C0MMANDS 

2.2.2,6 fi jl5_££sLd£H£.Jt/Lil£iiffl £_&as e.ij_an_£ ALtitLsm 



The following rules apply to static data defined by modules 
in monitor or task services? 

1) Only modules within monitor may declare static data that is 
mainframe wired* 

2) Only modules within ring 1 task services may declare static 
data that is mainframe paged* 

3) Only modules within ring 2 task services may declare static 
data that is in the job fixed segment. No modules may 
declare data in job pagable until the new system generator 



2-10 
ADVANCED SYSTEMS INTEGRATION PROCEDURES NOTEBOOK 

09/17/80 

■ ««««»» mm m m-mm m ** <m m mm m m mi m mm mm m m m m m m m m mm m mm m mmmm m*mm m mm m m «««i«t«*«MM«w« mm t 

2,0 NOS/VE OPERATING SYSTEM BUILDS *CI) 

2. 2,2.6 Data Res i dency/Li f et i me Based on Partition 



is available. 

4) Only modules within ring 3 task services may declare static 
data that is in the task private segment* 

5) Rules 1 through 5 also mean that a 1. 1 static data for a 
module in a given partition will reside as specified* 

6) Static data for modules that run in the ring of the caller 
(XLJ1FF) must be read only when executing above ring 3* 



2.2.3 MANIPULATION OF NOS/VE PARTITIONS AND LIBRARIES 

When building a system* monitor must be linked first. All 
gated symbols within monitor then become available to task 
services* which is linked second* Although some monitor 
symbols can be referenced by task services* the only way to 
execute monitor code is via the exchange jump — i*e»* the 
CALL/RETURN mechanism is not valid for use between monitor and 
job modes. User tasks are linked last and can reference gated 
symbols defined in task services* It is important to note 
that although the linker will allow a reference to a given 
symbol* the ability to actually reference the location is 
determined by the ring brackets on both ends of the 
reference* 



2*2*4 SYSTEM BUILD PROCEDURE DESCRIPTIONS 

In order to understand the procedure descriptions which 
follow, something should be said as to the sequence in which 
these procedures are used to generate systems* The following 
is an attempt to accomplish this? 

2.2.4.0*1 BACKGROUND INFORMATION 

I nj£&liiii£_ £li£_E£oj; &£ ux £ s. 

The procedures described below are documented as 
**SES *<Procedur e_Name>**. In actuality* to invoke the 
procedures in this manner assumes that there is a file named 
•PROFILE* in the current catalog which names the Integration 
catalog to search for the procedure {via the »SEARCH f 
directive)* The alternative mechanism for invoking these 
procedures is to code the procedure call as* 
M SES»<Integr at i on_Catalog>*<Pr ocedure_Name> w * Many of the 
procedures use the "PRCUNAM* value for subst i tutabi e user 
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names* meaning that the catalog in which the procedure is 
found is the catalog which is searched for flies. This is as 
it should be* since each of the Integration catalogs contains 
a different version of the system* 

All of the procedures described in this document have 

*"HELP M documentation associated with them. Use the 

SES*<Integr ati on_Catal og>*H£LP*<Procedure_Name> call to have 
procedure documentation printed at your terminal. 

There are two execution modes of NOS/VE which are referred 
to as the "standalone" mode and the **dua!-state w mode. All of 
the NOS/VE source modules which execute in the CY180 Virtual 
State are contained on a program library named f N0SVEPL f . The 
program interfaces to the Virtual State system* those 
described in the NOS/VE Program Interface ERS* exist as common 
decks on a program library named 'OSLPI*. The content of 
these two program libraries is referred to as the standalone 
system. A deadstart tape can be produced of the standalone 
system for execution on the hardware* or the output of the 
Virtual Environment generator can be executed directly on the 
Hardware System Simulator. The I/O support of this standalone 
system when running on the simulator is defined in a separate 
set of common decks on a program library named 'CYBICMN'. 
Refer to the Simulated I/O ERS for documentation of these I/O 
i nterf aces. 

The dual— state execution of NOS/VE* in conjunction with the 
NOS operating system* requires NOS system modifications and 
the presence of a set of NOS utilities and procedure files* 
The software which supports this dual-state environment from 
the 'NOS 1 side of the hardware Is contained on a program 
library named *VE170PL f . Included in this package of NOS/VE 
support programs is a software application called the Interim 
Remote Host Facility which suppl ies job-to— job communication 
between the Virtual State and NOS portions of the CY180 
machine. The Interim Remote Host Facility build procedures 
are not documented here at this time. 

2.2.4.0*2 THE BUILD SEQUENCE 

U £iUi£_£!2 £_lQU£e. e_L ifc£ MLL&S. 

The Integration project typically updates the base source 
libraries prior to starting any recompi I ation or assembly of 
the system. In order for a user of these procedures to modify 
the source of a system routine he/she can use the SES 
'GETMODS 1 procedure to extract the source being modified* or 
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create the source in some other manner* If GETMODS was used 
to extract the source* then REPMODS can be used to put this 
changed source on a MADIFY program library in the user's 
catalog* Then the filename containing this program library 
must be specified as the value of the * AB' parameter of the 
N0S8ILD procedure. {Refer to the Source Maintenance Section 
of the SES User's Handbook if you have questions about source 
mai n tenance* ) 

£o.ffi£ils£Ass£ffliiljB«l£Oj^iauLiI£ 

One must first determine ho** much of the system is to be 
compiled or assembled. If only a few modules Cless than 5\ 
are being compiled* then the NOSBILD procedure should be used 
with the 'M f option to update the appropriate files* If a 
larger number of modules <5 or more in the same system 
library) are to be recompiled* then it is * , cheaper ,, to use the 
•L* option and rebuild the entire system library from 
scratch. If more than two libraries are to be recompiled* 
then the NOSBILF procedure should be used to submit a separate 
execution of the NOSBILD procedure for each library to be 
rebuilt* This latter method is the one used for rebuilding 
all of the NOS/VE Virtual System from scratch. 

The general philosopy behind the NOSBILD procedure is to 
extract the latest source of a module from a program library* 
compile or assemble the source to produce the appropriate 
object text* replace/add the updated object text to the 
appropriate system library* and save this library in the 
catalog in which the procedure is executed* The final result 
of the execution of the NOSBILD procedure should be an updated 
system library in the current user's catalog which is ready 
for the •LINKER* phase of the build. Jobs which run in "user 
mode"* that is the interface to the system is &&Lx through use 
of the program interfaces (OSLPD* are saved merely as object 
text files in the user's catalog and LINKER-LOADER directive 
modifications are required to include these files as part of 
the system. This 1 atter capabi I i ty wi 1 1 gradual I y be replaced 
by the Virtual State LOADER and Library Generator features as 
they become available* 

The LINKER (SES.VELINK) and LOADER (SES.VEGEN) are packaged 
together in the Integration procedure NOSLINK. This is for 
convenience purposes* in that most LINKER changes to the 
system require a corresponding LOADER directive change* and 
the intermediate results from the LINKER execution are not the 
primary output used for system checkout. Prior to starting 
the LINKER-LOADER phase of system builds* some decisions need 
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to be made as to the target execution environment for the 
resultant output. 

If the target execution environment is standalone NOS/VE* 
then the default NOSLINK options should be used to produce the 
file named f LGB0K f . This file can be run on the simulator 
using the NOSSIM procedure* or can be used to create a 
deadstart tape using the f VSN» parameter of the NOSSYS 
procedure* 

If the target execution environment is a dual— state 
environment* then the OFFSET parameter must be used to specify 
how large the NOS system will be. The systems produced for 
the Arden Hills S2 use GFFSET*256 to produce a LGB256K file. 
The LGB256K file Is used by the NOSSYS procedure (when 
0FFSET*25& is specified) to produce a deadstart tape image on 
disk named f TP256K*. This deadstart tape image must then 
replace the file named TPXXXK* which the dual-state deadstart 
procedure UPMYVE will then find. Refer to Appendix E for 
Dual-State and standalone deadstart procedures. 

In order to generate a deadstart tape for standalone 
NOS/VE* it is only necessary to run the NOSSYS procedure and 
specify the VSN of the tape to be written. Prior to 
generating a dual-state deadstart file* however* it is 
necessary to verify that the utilities necessary to support 
the dual-state deadstart have been rebuilt via the DSBILD and 
BLDEI procedures. There are two portions of the dual— state 
EI* the A170 portion is built using the BLDEI procedure* and 
the C180 portion is rebuild using the NOSBILD procedure Cdeck 
named MLAEI) . 



2.2.4.1 Mfli£Ilfi-££fl££iy££-iifiS£Xi£i:iiiJDi 

The procedure NOSBILD is used to add or replace modules on 
a base object text file. NOSBILD retrieves the source module 
from a program library* using the following search order* 

1) an alternate base optionally specified by the 
user (looking first in the current catalog* and 
then in the <Integr ati on> catalog) 

2) OSLPI (from the <Integr at ion> catalog) 

3) NOSVEPL (from the <Integr ati on> catalog) 

This module is then compiled or assembled* and the 
resulting object text is either added to or replaced on a base 
file. A new version of the base file will be created in the 
current catalog* along with the direct access file NQSLIST 
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which contains the compilation or assembly listingCs) of the 
module(s) compiled or assembled Cone listing per record* 
headed by the matching MADIFY module name* listed via the 
IISTNVE procedure described in this document)* If there are 
any compilation errors* the error listingCs) will be put on 
the direct access file RPTERR2 (which has the same format as 
NOSLIST) in the current catalog* The indirect access file 
RPTERR1 will contain the message "COMPILATION ERROR IN DECK 
<module>. w for each module which had compilation errors* Any 
GENCOMP errors will cause a similar message to be written to 
the indirect access file CMPERR1. 

If a specified module is to be replaced (i.e. it is 
already part of the existing system)* NOSBILD will by default 
use the same compilation options and will replace it on the 
same base object text file as when it was first added to the 
system* These options may be overridden by specifying the 
corresponding parameters described below* 

If a specified module is new to the system* the compilation 
and base object text file options may be directly specified 
using the parameters described below* If a klsX of new 
modules is specified* the compilation and base file options 
must also be specified as lists* and NOSBILD will match 
everything up posi ti onal ly* If these parameters are fiai 
specified* and NOSBILD is executing in LOCAL mode* a warning 
message will be issued telling the user that the module is not 
in the current system* The user will then be prompted for the 
necessary information* If these parameters are not specified 
and NOSBILD is executing in BATCH mode* the compilation and 
base file options default as specified below* 

If the »!• parameter is specified * each module's object 
text will be copied to a temporary f z* file. The old library 
file will then be purged* and the f z* file will be renamed as 
the new library file* All compilation listings will be 
LI8EDIT«ed onto NOSLIST from a temporary listing file at the 
end of the procedure* 

When an entire library is being rebuilt via the f l* 
parameter* the module names and their corresponding 
compilation options are obtained from a file which contains 
all this information for each library* NOSBILD searches for 
this file first in the current catalog* and then In the 
<Integrati on> catalog* The name of this file &u&£ be the name 
of the library minus its first character le.g. f LJ13F f for 
the library »XLJ13F«)* and the first line of this file mjisj; be 
the file name. To make additional entries or change existing 
entries in this file* the following procedure should be 
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NOSBILD (with the M« parameter specified) may then be used to 
rebuild the library using these new/modified compilation 
opt i ons. 



The format of the NOSBILD is as foil 



SES. NOSBILD 



ows J 



1 



m=C<module name>..<modul e name)) 

!»< library name > 3 

c»C <comp i I ation op tion>. ,<compi I ati on option>) 3 

xref*l< xref opt ion>..<xr ef optlon>) 3 

II * (<base file>..<base fiie>) 3 

ab » <alternate base> 3 

omit * (<module name>..<modul e name>) 3 

link I link » <offset value> 3 

test ■ <test file name) 3 

print 3 

batch 3 



m i 



The modui e name* 
module names. 



or range of modules* or list of 



The library name. Only one library at a time may 
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be selected* To select more than one* use the 
NOSBILF procedure* 

c * c * to assemble a module 

c • 1 to compile a CYBIi module (DEFAULT) 

c « 2 to compile a CYBIL module without range 

checking 

c * 3 to compile a CYBIL module using CY8ICMN type 

declarations 

c » 4 to compile a CYBIL module using CYBICMN type 

declarations* and with range checking turned off 

xref * •YES 1 to run a cross reference (CYBREF) 

•NO* to not run a cross reference (DEFAULT) 

II i The base file (list of base files) onto which the 

module (list of modules) is to be added or 
replaced* If a new module* the default is 
»XLJ1FF». 

ab 5 The user's alternate base program library 
containing new and modified modules* The default 
is »NEWDKPL«* 

omit : Used when running a full build* a module name or 
list of module names to omit from the build* The 
def aul t is none* 



link : Option to link the newly built or modified system 
using the procedure NOSLINK* Specifying simply 
the keyword *LINK» or 'LINK * 0» links a NOS/VE 
stand-alone system* To link a dual state system, 
specify 'LINK « <offset> 1 where <offset> may be 
given the values 256* 128* or 64* The default is 
to not link the system. 

test i The name of the file containing the NOS/VE test 

commands to be input to the simulator* which will 
be executed after the system has been linked 
(using procedure NOSSIM)* This parameter is 
invalid if the 'LINK* option has not also been 
specified* The default is to not run the 
simulator test* 

print J Option to. print the link map following the linking 
of the system* The default is not to print the 
1 i nk map* 
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batch s Run NOSBILD in BATCH mode. The default is to run 
i t 1 oca! 1 y* 

M0IE-. * One of •«• or * I* parameters fust be specified. 

2.2*4*2 MQiaii£_££fi£ejdu££-i&£C.£l£iiiIO 

N0SBI1F is an SES procedure fife which submits one batch 
procedure execution of NOSBIiD for each system library* each 
with the * M parameter specified for the library to be built* 

The format of the NOSBILF is as follows? 

SES.NOSBILF C I » <l ibrary name >1 
C batch 3 

I s The • I 1 parameter specifies the library to be 
built* It can be one library or a list of 
libraries* The default is to rebuild the entire 
system* 

batch 5 Run NOSBILF in BATCH mode* The default is to 
run i t I oca I ly. 

Note s To rebuild one library* the following are 
i dent i ca 1 * 
II SES.NOSBILF l«< library name > 
2) SES. NOSBILD l*< library name > batch 

2*2.4*3 LIIIMI£«££A£fidy££.££4ii£i£iiaQ 

LISTNVE is an SES procedure file which extracts the 
compilation listings of the modules specified by the f M f 
parameter (module names correspond to the MADIFY deck name 
given the module) from a text library file and writes them to 
the file specified by the f F* parameter in a printable 
format* The *N f parameter may select a single module* a list 
of modules* and/or a range of modules on the library file* 

The library file which contains the listings may be 
selected via the 'I* parameter* and defaults to NOSLIST* 
LISTNVE will search for this file in the current catalog 
first* and if it is not there it will go to the catalog 
specified by the 'UN 1 parameter* 



When LISTNVE has completed* the output file selected by tin 
1 parameter will be a local file. It is fi£± automatical I : 

. _ i _ a. i .._«___ _ I a. «_ -* _ a. i innf tin _ _ a r» a »/» 1 1 • ^ _ a. x — _ l 



ie 
y 
printed unless either the »PRINT» or ♦BATCH 1 option is 
sel ected* 
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The format of the LISTNVE is as follows* 

SES. LISTNVE C m * t <module name>. . <modui e name> ) 3 

i i « <f i 1 e name) 3 

t o » <print file name) 3 

t un « <user name> 3 

I print 3 

C batch 3 

m i The module name(s) and /or range of module 

names which are to be extracted for 
printing. The default is to extract and 
format ail of the modules. 

i * f 1 from J The name of the text library file from 

which the compilation listings are to be 
extracted. The default is NOSLI5T. 

o J to 1 upon : The name of the file which will receive the 

formatted listings to be printed. The 
default is LISTING. 

un s The name of the catalog to search for the 

library file should it not be found in the 

current catalog. The default is the 
<Integr at i on> catalog. 

print ? Option to print the fisting file after it 

is formatted. The default is to not print 
the listing file. 

batch : Run LISTNVE in BATCH mode. The default is 

to run i t I ocal 1 y. 

2.2.5 NOSLINK PROCEDURE DESCRIPTION 

NOSLINK is an SES command language procedure file which * 

will call both the VE Linker and VE Generator (using the * 

standard SES procedures VELINK and VEGEN) to produce a S 

checkpoint file and link map file. In order to do this it ' 

will link monitor and task service routines from their object < 

text files. It will search all files that it requires 1) from ! 

local files 2) from the current catalog* 3) from area user's I 

catalog (if the area parameter is specified)* 4) from the S 

<Int egr ati on> catalog. * 

NOSLINK will link either a stand-alone or a dual state « 
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system. The choice is made via the OFFSET parameter <see 
description below). NOStINK will put the checkpoint file on 
the direct access file LGB<of f set>K# and the link map %« i t f be 
placed on the direct access file MAP<of fset>K* where the value 
given the OFFSET parameter is substituted into each name for 
<of f set>. 

To link additional user Jobs into the system* create a file 
in the current catalog containing the commands needed to 
obtain ail the necessary files as well as a call to VELINK for 
each user job to be linked. Specify this file via the ADD 
parameter* and NOSLINK will pick it up and physically insert 
it into procedure command stream immediately following the 
last call to VELINK. Ii3^Xi£5l-.liD£^ill-lM^lii5.f!yiI-ii£-lllfi 
Xil£~Iiai£lI_ 

The format of the NOSLINK is as follows: 

SES. NOSLINK t offset * < load offset > 1 
I save 3 
C quick 3 

C uj « ( < user job >>•*.»< user job > ) 3 
C add = < additional links file > 1 
C print ] 

C test ■ < test file name > 3 
£ dump 3 

C area « < user name > 3 
C batch 3 

offset s The load offset* used to determine whether to 
link a stand-alone or a dual state system. 
OFFSET * links a stand-alone system {DEFAULT) 
OFFEST ■ 256 links a dual state system (to use 
on the S2) 

OFFSET * 128 links a 128K dual state system 
OFFSET * 64 links a 64K dual state system 

save : Option to save the monitor and task services 
segment files created during the link for 
subsequent "quick link* use by this procedure. 
The default Is not to save these segment files. 

quick : Option to do a "quick link". A more complete 
description of this option can be found in the 
section entitled "Quick Link Option of NOSLINK 
Procedure". The default is not to do a quick 
1 i nk. 

uj * File or list of files containing the existing 
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user job binaries that are to be linked into the 
system* The default Is to link in jJJL existing 
user Jobs* 

add s The name of the file containing the commands 

needed to link additional user jobs into the 

systenu The default is to not link in any 
additional user jobs. 

print * Option to print the link map. The default is 
not to print the link map. 

test s The name of the file containing the NOS/VE test 
commands to be input to the simulator* which 
Mill be executed after the system has been 
linked (using procedure NOSSItt). The default is 
to not run the simulator test. 

dump ? Option to print a memory dump of the system. 
Default is no memory dump. 

area « Option to obtain the object files or linker 
parameter files from another user's catalog 
(other than the current catalog in which the 
procedure is executing). The default is for no 
area user catalog to be searched. 

batch ? Run NOSLINK in BATCH mode. The default is to 
run it I oca I ly. 

2.2.5.1 L££_ £il e_a e.s£ £ JLfiliJin 



The LINK commands used in the NOSLINK procedure do not 
specify enough information to totally define the requirements 
of the linking operation. Many additional parameters are 
supplied to the linker through additional data files. This 
Includes information such as* 

- Ring Numbers 

- Segment Numbers 

- Segment Attributes 

- Execution Privilege 

Currently this information is supplied to the linker via 
the SES Linker Parameter File (LPF) file. The linkage between 
the linker and the LPF file is activated by the LPF«LIBLCB 
parameter on the LINK commands. For the monitor linkage this 
information Is on LPF file MTRLCB* task services linkage 
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information is on LPF file STSLC8* and EI/EIE linkage 
information is on EILCB/EIELCB respectively* 

2*2*5.2 M£Ln£B-l-.LaR^£ll£-fi£Sil£i£liiiG 

The VELDCM fife used by the procedure NOSLINK contains 
directives to the CPF Generator which allow it to produce a 
checkpoint file from the segment files produced by the V€ 
Linker. These directives set up the physical environment into 
which NOS/VE is placed* and include such things as the 
definition of the page size* job and monitor exchange package 
addresses* page table address and length* preallocated segment 
array definitions* etc* 

VELDCM is a "skeleton 1 * file which is dynamically edited 
during the execution of the NOSLINK procedure* depending upon 
the specification of the OFFSET parameter. The edited file is 
then put on a direct access file named LDR<offset>K (where 
<offset> is replaced by the value given to OFFSET when the 
procedure was called) in the user*s catalog. It contains the 
directives to the CPF Generator which set up the physical 
environment for that particular link* This file must remain 
permanent in the user's catalog after NOSLINK has been 
executed* as the procedure NOSSYS uses this file in building a 
deadstart tape. 



2.3 miM£-U3££_IASJi!-I2-£0m£ 



2.3.1 INTRODUCTION 

A user task can be defined as a group of modules linked 
together that will execute in the f user ring* of NOS/VE* 
currently ring 11. This task may make calls to any gated 
entries within task services (rings 1 through 3) if the call 
bracket will allow the call* Data defined within task 
services may not be referenced from rings 4-15* 

2.3.2 QUICK LINK OPTION OF NOSLINK PROCEDURE 

To do a "quick link"* specify the QUICK option on the call 
to NOSLINK (see the section entitled "NOSLINK Procedure 
Description ). In this case NOSLINK does not fink monitor and 
task services from their object text files each time. 

Instead* it uses &±L£ASlX liakfiil monitor and task service 

environments* and just links the specified user object files. 
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The QUICK option causes NOSLINK to run faster and requires 
less resources than the full link* and therefore should be 
used instead of the full link when flflly^ysex^fcastSS are being 
added to NOS/VE. 

NOSLINK, with the QUICK option specified, should not 
require any modification to execute in different user task 
configurations* The user can merely name the user object text 
file produced by an assembly or compilation as *XUU$ER1*. To 
link additional user object files into the system, either 
specify the existing files to be linked via the UJ parameter, 
or specify the necessary command file via the ADD parameter* 
The contents of this file, its use, and the function of the UJ 
and ADD parameters are described in greater detail in the 
section entitled "NOSLINK Procedure Description'** 



2*4 mm_SIMLMXIlfci 



2.4.1 RUNNING A SIMULATOR TEST {NGSSIM PROCEDURE) 

NOSSIM is an SES procedure file which will run either a 
batch mode or an interactive simulation of NOS/VE* This 
option is selected via the •TEST 1 parameter. If f TEST f is not 
specified, then the simulation will be run interactively. If 
a batch mode simulation is desired, then 'TEST 1 is used to 
specify the name of the file containing the NOS/VE test 
commands that are to be Input to the simulator. The » BATCH* 
keyword must also then be specified* If the user wants to use 
his/her own simulator directives file, the 'CMOS* parameter 
must be specified* 

NOSSIM also allows the selection of the checkpoint file to 
be used for the start of simulation* A checkpoint file may 
also be optionally saved at the end of the test* The C180 
memory size may be changed via the •MEM* parameter. 

The NOSSIM procedure will create several permanent files in 
the user*s catalog if not run interactively. These are 
itemized as follows: 

1) IQiilEUI* This direct access file contains all of the 
output of the NOSSIM procedure, including 
- a copy of the command file used as input to the 
simulator ('TEST* parameter) 
the output produced by the system 
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- the SESLGG file 

a reformatted keypoint listing 

- DEBUG output (if '•SIHDBG 1 was specified on the 
NOSSIN cat I) 

a summary of all (paging) disk I/O {HIOLOG file) 

- the load map produced by the CITOII conversion and 
execution of XUUTL (SIHLOAD file) 

(optionally) a hex dump of the checkpoint file at 
the end of simulation 
the job dayfile. 
This file is automatically sent to the line printer. 

2) ££££M£» This direct access file contains the keypoint 
data produced by the simulator. It is reformatted by 
the procedure NOSKEY before being written to the file 

TOUTPUT. 

3) IP.M£» The dayfile of the NOSSIM job will be written 
to this direct access file should it terminate 
abnormal I y. 

Add! tional ly> if the »NCPF* parameter is specified* NOSSIH 
will create 4 direct access files which together contain the 
NOS/VE environment at the end of simulation. The file 
specified by the f NCPF' parameter will contain the current 
NQS/VE checkpoint file. The other 3 files * formed by adding 
the characters 0* 1* and 2 to the 'NCPF 1 file name - which 
must therefore be six or less characters long) are used for 
NOS/VE memory paging. 

The format of the NOSSIM is as follows: 

SES.NOSSIM C test » < command file > 3 

t cpf * < checkpoint file > 3 

C ncpf * < new checkpoint file > 3 

C mem * < memory size in hex > 3 

I cmds * < simulator directives file > 3 

C nods 3 

C simdbg 3 

I dump 3 

C batch 3 

test : The file containing the NOS/VE test commands* 
The default is to run interactively. 

cpf 5 The checkpoint file used for the start of 
simulation. The default is "LGBOK". 

ncpf : The checkpoint file to be saved at the end of 
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simulation. The default is not to save a 
checkpoint file. 

mem J The C180 machine memory size* in hex* needed to 
run the simulation* The default is 
W !00000U6) M . 

cmds i Simulator directives file which should foe 

supplied by the user. The default is to use the 
one created by the NGSSIM procedure. 

nods i Option to use the version of the checkpoint file 

from the <Integr at lon> catalog which has already 
been deadstarted. The default is to use a 
checkpoint file which has not been deadstarted. 

simdbg ? Option to turn DEBUG on for the current 
simulator run. The default is to run with DEBUG 
off. 

dump J Option to include the dump of the checkpoint 
file at the end of simulation as part of the 
NGSSIM output. The default is not to dump the 
checkpoint f i 1 e. 

batch * Run NOSSIM in batch mode. The default is to run 
it 1 ocal ly. 



2.4.2 NQSKEY PROCEDURE DESCRIPTION 

NOSKEY is an SES procedure file which creates a simulator 
generated keypoint trace file* Tlie output of this procedure 
is the local file »KEYFILE». 

The format of the NOSKEY is as follows* 

SES. NOSKEY I kpf « < keypoint file > 3 

kpf : The keypoint file generated by the simulator 
which is used as input to XXM7KEY. The default 
is 'SESSMKF*. 

2*4.3 DUMPING A SIMULATOR CHECKPOINT FILE (NOSDUMP PROCEDURE) 

NOSDUMP is an SES procedure file which makes a DSDI dump of 
a simulator checkpoint file. 



2-25 

ADVANCED SYSTEMS INTEGRATION PROCEDURES NOTEBOOK 

mmmm! ^„ mmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmm 2tiiiiii t 

2.0 NOS/VE OPERATING SYSTEM BUILDS (CI) 

2.4.3 DUMPING A SIMULATOR CHECKPOINT FILE (NOSDUMP PROCEDURE) 



The format of the NOSDUMP is as follows? 

SES. NOSDUMP I cpf » < checkpoint f i I e > 1 

C I * < output f He > 3 

t dump * STND J ALL 3 

I print 3 

C batch 3 

cpf * The checkpoint file which is to be dumped. The 

default is **CKPT". 

I J The file which is to receive the dump output* 

This file will be a local file after the 
procedure has finished execution. It is &sl 
automatically printed* The default is 

"DSDIGUT". 

dump 5 Option to either dump the environment according 
to ASID (DUMP*STND) or dump the entire 
environment <DUMP*ALL). If W DUMP*STND» is 
chosen* then the DSDI directives are taken from 
the file DSDIX* which the procedure will search 
for first in the current catalog and then in the 
<Integr ati on> catalog. The default is 
*»DUMP*STND W . 

print : Option to print the DSDI dump output. The 
default is not to print the dump* 

batch : Run NOSDUMP in BATCH mode. The default is to 
run i t I ocal ly. 



2.5 filiIlflIMfi-AJ2£AMIARI-£lL£ 



2.5.1 INTRODUCTION 



2.5.2 CREATING THE FILE (NOSSYS PROCEDURE) 

The SES procedure NOSSYS builds a deadstart file from the 
checkpoint file created by the linking of the system. The 
•OFFSET 1 parameter allows the option of building either a 
stand-alone or a dual state deadstart file. If the parameter 
•VSN* Is specified* then the deadstart file will be written to 
tape; otherwise it is written to the file TP<offset>K where 
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the value of the •OFFSET 1 parameter is substituted for 
<offset> in the name of the file, 

NOSSYS requires additional object files for inclusion on 
the deadstart file. These object files contain ?? object code 
for the following functions? 

1) Deadstart (file XIDST) 

2) 844 driver (file XIDSK) 

3) Console/Printer drivers Cfile XIDSP) 

4) ?? helper (f i ie XIHLP) 

5) ?? Resident program (file XIRES) 

6) Others to be defined later 

If these files are not present in the current user catalog* 
they will be obtained from the appropriate catalog. lie* 
SES>INT2» prefixed procedure calls access INT2 level system 
files only* while S£S#INT1. prefixed procedure calls may 
access files from either INT2 or INT1 catalogs as is 
appropriate for the system being built.) 

A copy of the iinkmap file { I i nker /I oader output) will also 
be included on the stand-alone deadstart file. A copy of the 
loader directives will be included on the dual state deadstart 
file. These are the files MAP<offset>K and LDR<offset>K 
(descriptions of these files are included in previous 
sections)* and must be in the same catalog as the file 
specified by the • CPF 1 parameter* 

The format of the NOSSYS is as follows! 

SES. NOSSYS [ vsn » < tape vsn > 3 

C offset « < load offset > 3 

C cpf * < checkpoint file > J 

C cybl ink 3 

C batch 3 

vsn s The VSN of the tape to be written. This file 
must be available to the operator. The default 
is to write the file to a tape as specified 
above. 

offset : The load offset* used to determine whether to 
build a stand— alone or a dual state deadstart 
file. 

OFFSET * builds a stand-alone deadstart file 
(DEFAULT) 

OFFSET ■ 256 builds a dual state deadstart file 
(to use on the S2) 
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OFFSET ■ 128 builds a dual state deadstart file 
for a 128K system 

OFFSET « 64 builds a dual state deadstart file 
for a 64K system 

cpf J The checkpoint file used In creating the 
deadstart file. If the file does not exist in 
the current catalog* it will be obtained from 
the CIntegrati on> catalog. The default is 

LG80K. 



cyblink t Option to create a tape for CYBERLINKING to 
CANCCD. The default is to build a hardware 
deadstart f i le. 

batch : Run NOSSYS in BATCH mode. The default Is to run 
it I oca I §y. 

2.5.3 COMPILING 180 ?? CODE <CPP180 PROCEDURE) \ 

CPP180 is an SES procedure file which compiles 180 PP J 

code. The source for the PP code may be retrieved from a * 

source file (**SF H parameter) or a program library l**M M J 

parameter). If the W AB W parameter is specified* CPP180 will ! 

search this PL first before searching NOSVEPL to satisfy • 

externals. The W UN* parameter specifies the catalog in which 5 

M AB*» resides. NOSVEPL comes from the <Integr at i on> catalog. J 

The format of the CPP180 is as follows: J 

SES.CPP180 C m * < module name > 3 J 

C sf * < source f i le name > 3 t 

C ab * < alternate base > 3 * 

t un ■ < user name > 3 « 

C print 3 J 

C batch 3 5 

m : The module name of the PP program to be * 

compiled. If "M" is not specified then W SF W J 

must be specified. J 

sf 3 The source file residing in the current catalog * 

which contains the 180 PP source code for the P? * 

program to be compiled. If •SF* is not I 

specified then n M H must be specified. 5 

ab : The alternate base searched by CPP180 to satisfy * 
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externals before searching NOSVEPL. The default I 

is to search only NOSVEPL. I 

un 5 The user name of the catalog containing the 2 

alternate base specified by the W AB** parameter* * 

The default is the current catalog, * 

print s Option to print the assembly listing. The I 

default is to not print the listing* * 

batch 8 Run CPP180 in BATCH mode* The default is to run 5 

1 1 I o c a I I y • I 



2*6 mL_iIAI£_EBfl£EJHl£E£ 



2.6.1 BLDEI PROCEDURE DESCRIPTION 

BLDEI is an SES procedure file which builds the absolute 
file for dual state EI. The I parameter may be specified if a 
file containing the dual state EI sjmt.cs exists in the current 
catalog; otherwise BLDEI retrieves EI from NOSVEPL in the 
<Int egr ati on> catalog* 

BLDEI uses the linker parameter file EILCB to link EI. If 
this file does not exist in the current catalog* it is 
obtained from the <Integr ation> catalog by the procedure. 

The outputs of BLDEI include the direct access absolute 
file f EI' and the direct access file •EILIST 1 which contains 
the assembly listing and the link map for EI. 

The format of the BLDEI is as follows* 

SES. BLDEI C i * < EI source file > 3 

i s The file in the current catalog which contains 
the dual state EI sautes from which EI is to be 
built. The default is to get the EI source from 
NOSVEPL in the <Integr at i on> catalog. 



2.6.2 CPUMBLD PROCEDURE DESCRIPTION 

CPUMBLD is an SES procedure file which builds the dual 
state binaries for CPUMTR* which will be put on the direct 
access file XCPUMTR. The »I f parameter may be specified if 
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the compile file for CPUMTR exists in the current catalog; 
otherwise CPUMBLD retrieves CPUMTR from VE17QPL* searching 
first in the current catalog and then in the CIntegr at ion> 
catalog* The assembly listing will be written to the direct 
access text library file DSLIST* with the heading CPUMTR* 

The format of the CPUMBLD is as follows: 

SES. CPUMBLD t i « < CPUMTR compile file > 3 
I batch 3 

i s The file in the current catalog which contains 

the dual state CPUMTR compile file from which 
the CPUMTR binaries are to be built* The 
default is to get CPUMTR from VE170PL in the 
<Integrati on> catalog* 

batch : Run CPUMBLD in BATCH mode. The default is to 
run it I ocal I y* 

2*6,3 CTS8ILD PROCEDURE DESCRIPTION 

CTSBILD is an SES procedure file which builds the dual 
state binaries for CTS and MXS and puts them on the direct 
access file XCTS* The assembly listings for CTS and MXS are 
written as one record to the direct access text library file 
DSLIST, with the heading "CTS". 

The format of the CTSBILD is as follows: 

SES*CTSBILD C batch 1 

batch s Run CTSBILD in BATCH mode* The default is to 
run it locally* 

2*6.4 DSBILD PROCEDURE DESCRIPTION 

DSBILD is an SES procedure file which builds the dual state 
binaries XDSTVE* XRUNVE* and XTRMVE* All assembly and ISWL 
compilation listings are put on the direct access text library 
file DSLIST lone listing per record* each headed by the 
corresponding MADIFY deckname) and the three load maps are 
saved on the direct access file DSMAP* 

The format of the DSBILD is as follows* 

SES. DSBILD C batch 3 
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batch s Run DSBILD in BATCH mode. The default is to run 
it 1 oca! ly. 



2.6.5 PP8ILD PROCEDURE DESCRIPTION 

PPBILD is an SES procedure file which builds the dual state 
PP binaries for MMCPP and PPHELP* which will be put on the 
direct access flies XMMCPP and XPPHELP respectively. Both 
assembly listings are put on the direct access text library 
file DSLIST (one listing per record* each headed by the 
corresponding MADIFY deck name). 

The format of the PPBILD is as follows* 

SES. PPBILD I batch 3 

batch : Run PPBILD in BATCH mode. The default is to run 
i t I ocai I y. 
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This section describes how to install all of the files 
needed to run NOS/VE in Dual State mode. To do this from 
"scratch** the following materials are necessary? 

1 CMSE tape 

1 CTI tape 

1 EI tape 

1 Dual State NQS Deadstart tape 

- The LOADPF tapeCs) which contain the NOS/VE environment 

If CF1SE* CTI* and EI are already present and correct* then 
it is only necessary to install a new deadstart sector on disk 
or to load a new NOS/VE environment. If A170 NOS has been run 
on this machine prior to the installation of NOS/VE* then 
chances are excellent that the proper versions of CASE and CTI 
were used* There are incompatibilities between the A170 
EI/NOS system and the Dual State environment which preclude 
the usage of these same materials* however. 

3 . 1 fiL£AB-£fll!II£&S-AJafl-IllSIAU-£Il 

To clear the pointers* deadstart from the CTI tape which is 
MT» D*800* F*SI* LB«KU* and enter* 

*U* — ->R (Release) 
Channe I «xx 

€ q»XX 
Un 1 1 * x x 

Deadstart again and then enters 

*U*~ — >I (Install D/S module on disk! 

Channel«xx 

Eq*xx 

Uni t*xx 
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To install CMSE* deadstart fro® the CASE tape which is MT* 
D«800* F*SI* and then enter: 

DT*2 

CHANNEL*xx (CMSE tape) 

TDX 

•C» option (Build directory in CM and copy to disk) 

Device type*x 

Channel «xx 

Eq*xx 

Uni t = xx 

MT type*3 

MT channel*xx 

Eq^xx 

Uni t«xx 

User type*02 (Shared 0/S) 

Install options»02 

0ptions*01 (Build without D/S sector since it was 

already created by CTI«) 



3.3 JQfL£I£_SlHJEI 

To delete the old Error Interface (EI) filet deadstart from 
the unit where CMSE is installed* then enters 

*M* 

Then to display the list of binary files and check if EI is 
there* enters 

AF, 

*DP EI (will delete EI if it is there) 

opt i *WK INSTRO COO (to write microcode from P2 to CMSE 

disk - takes a long time) 



3.4 IMmLi-£I 

To install EI mount the EI tape which is MT* D«800* F*SI* 
LB*KU* and deadstart from the unit where CMSE is installed* 
Then enters 

*M* 

TDX 
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CCR> <A directory for CnSE already exists* so this 
will update the directory.) 
Disk Type* xx 
Channei*xx 
Eq*xx 

Device TypeMEI tape) 
MT type*xx 
Channel* xx 
Eq*xx 
Uni t*xx 
User type*02 
User 0ptions*02 
0ptions*02 <Add a new program) 

When END appears* EI is installed. 

3.5 IBSIAU-SXSIffl 

Deadstart from the NOS Dual State deadstart tape, using the 
deadstart tape which is to be installed. Choose the f f 
option on the first display* for operator intervention. Then 
choose the , H f option on the next display to see the hardware 
parameters. Enter CM*10000. Optionally* the *P f display may 
be selected to choose a CHRDECK. (CMRDC14 contains the CANCDD 
S2 configuration* CMRDCK6 contains the ARHOPS S2 
configuration.) After the system is deadstarted* enter the 
following commands* 

X.DIS. 

C0HM0N*SYSTEM. 
INSTALL*SYSTEM*EQxx. 

NOTE? xx is the EST ordinal of the disk where the deadstart 
sector is to be installed; this is the same disk where CMSE 
was installed previously. 

3.6 IQAfl££-£U.£fi 

The LOADPF tapes* which are NT* Q*?E, F*SI* and L8*KL* 
contain the NOS/VE operating system source and binaries* tools 
to assemble and link the operating system* and various other 
files. Included in these files is the DSINSTF file which 
contains the Dual State execution environment. 

Deadstart from the disk upon which the NOS Dual State 
system was installed* LOADPF the files to the desired user 
number* and install the Dual State execution environment in 
the following manner* 
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ATTACH#DSINSTF 



ATTACH#DSINSTF. 
8EGIN#DSXNSTF#DSINST#S€AT=cat>INST=FULL. 



where! cat is the user number of the catalog in which the 
execution environment is being installed, {In ARHOPS this is 
the DEVI catalog.} 

Check the indirect access file CMDS1 to make sure it 
reflects the hardware conf igur at ion: 

*RELOADCH=x. x should be an empty channel. 

*DISKCH=y. NOS cannot use channel y with Dual State active. 
*SYST,DISKUz*ON. z can only be through 3. i 

(Unit z on channel y £,anjiQ.Jt appear 
in the NOS CNRDECK or EST.) 



3.7 MIii£-U£-DiliL-iIM£ 

After the NOS Dual State system has been deadstarted> and 
the Dual State execution environment has been installed* 
NOS/VE is brought up by entering the following console 
command* 
X.UPMYVE{CAT«c) 

where! c is the user number in which the execution 
environment was installed. Enter K»n* (n * the control 
point number of the UPMYVE job) to see the NOS/VE display. 
K.*BY£VE. will terminate NOS/VE. For further information 
regarding the operation and execution of this environment 
refer to the $2 Machine Usage Document. 
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«.l IMIEQDU£IIQM 

The verification currently performed on NOS/VE systems 
consists of the following* 

1) running the simulator test input contained on file 
VQLTST3 until visual examination of the output from this 
test warrants that further testing should be performed* 
and 

2) running the S2 Regression Test Sequence* as outlined in 
the following sections* on the hardware. 



4.2 ££_R££££iIII2iLimi 



4. 2,1 REGTEST 

REGTEST is a file containing a sequence of HCS commands* 
It runs a series of user test programs on the hardware* and 
puts quite a heavy load on the system* REGTEST takes 
approximately 20 minutes to run. The command sequence 
follows: 



EX UUTL *BULK*2* 

PESTATS 

EX UUTL *CALLER*UUTL»10***TESTM£M*1000000*** 

EX SORT *2000*100* 

EX UUTL *CALLER*S0RT*5**1000*50*** 

EX UUTL *TESTN0V€. 1000000* 

EX UUTL *A170*10* 

EX UUTL *LOOP. 30000* 

TMTERM UUTL 

EX UUTL *CALLER*UUTL*10***CYCL£* 30000*** 

TMTERM UUTL 

EX UUTL *CALL€R*UUTL*5***L00P*18Q0*** 

EX UUTL *CALLER*UUTL*5***TIME0UT*100*180Q*** 

/SSET QUANTUM 5000 

/SSET PITVAL 1000 

EX UUTL *CALLER*UUTL*5***BULKNTC*2*** 
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EX UUTL *CALL£R*SGRT*5***1000,50*** 
EX UUTL *T£STM0VE*1Q00000* 
TSTATUS 
JMEXIT 



4.2.2 TESTBAM 

TESTBAM is a file containing the statements necessary to 
execute a)! of the BAM test cases supplied by W. V* Mahal. 
These procedures exercise various portions of the basic access 
method* and are used to show some level of confidence that BAM 
works as well as it has previously. The command sequence 
f ol I owss 



EX BAMTEST 

TES1 

TES2 

TES3 

TES4 

TES5 

TES6 

TES7 

TES8 

TES9 

TES10 

TES11 

TES13 

TES14 

TES15 

TES16 

TES20 

BAMSTGP 

JMEXIT 



4.2.3 J0B1 

J081 is a file containing the NOS/VE commands which stage a 
CI object file from the 170 side to the 180 side* convert this 
file to an II library file* and replace the II library on the 
170 side. It tests the following NOS/VE features: 

LINK_USER command 

GETPF B60 

CITQII conversion 

Object Library Generator 

Display Library Information 

REPLACE B56 
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JMEXIT 
The command sequence follows: 



EX ZDIS**A 

SCL 

LIU*USER»<INTl*NV£)*PA=INTlX,A»NaTUS£D*PR*NOTUSED 

HCS 

G£T*CITEXT180*CYBILGG** »NV£*860 

EX CITOII *CITEXT180*IIT£XT180* 

EX COL 

ADD*GF»IITEXT180 

DILIB*QN=A 

GEN*LI8RARY*LIBRARY180 

END 

REPLACE*LIBRARY180*CYBIILB***NVE*856 

JMEXIT 



4.2,4 J0B2 

J0B2 is a file containing the NOS/VE commands which stage 
an II library and a CI user job object file from the 170 side 
to the 180 side* convert the CI user job object file to an II 
object file* and then load and execute this user job with the 
library. It then stages the LOADMAP back to the 170 side to 
be printed. J0B2 tests the following NOS/VE features* 

LINK_US£R command 

SET_0BJECT_LIBRARY (SOL) command 

SET_PRGGRAM_aPTIGNS (SPO) command 

GETPF B56 

GETPF B60 

CITOII conversion 

Load/Execute User Program ♦ Library 

JNROUTE C180 print file 

JMEXIT 

The command sequence follows: 



EX ZDIS»*A 

SCL 

LIU*USER«(INTl*NV£)*PA«INTlX*A=N0TUSED*PR*NaTUSED 

SOL*ADD*N£WLIBRARY 

SPO*MO»<B*£*X»S)*EA»FATAL 

HCS 

GET,NEWLIBRARY*CYBIILB***NVE*85& 

G£T*XUS0RT*XUS0RT***NVE*B60 
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EX CITOII *XUSORT.LGO* 

EX LGO 

JMROUTE,NQTUS ED, LOADMAP, PR, REMOTE 

SCL 

SOUD£LETE«A!_L 

HCS 

GET»CYBILIB»CY8IItB^tNVE#B56 

EX LGO 

J MR OUTEfNOTUS ED, LOADMAP, PR ^REMOTE 

JMEXIT 



4.3 ^.E£fiS£5aian.i£ii^iiaj£ii££ 

1) Mount S2 System Scratch pack on 844 Unit 1. 

2) Initialize memory* 

Set the deadstart panel to disk deadstart from* 

CH»1 

UNIT*43 

WORD 13*0106 

WORD 16*0000 

- Push deadstart button. 

- Hit carriage return* 

System should go through a very lengthy "CHECK 
COMPUTER MEMORY" step and then stop and display 
the CMR deck. 

- Reset panel to desired setting and r e-deadstart. 

3) Deadstart A170 NOS. 

4) If necessary* update the INT2 catalog and load the 
latest system files into the INT1 catalogs 

- Mount the INT1 catalog DUMPPF tape on Unit 0. 

- X.DIS. 
USER,INT1,INT1X. 
CALUUPCATS. 
DROP. 

The UPCATS procedure performs the following functions: 
a) Updates the INT2 catalog with the following files 
from the INT1 catalog: 

- the NOS/VE deadstart file CTPXXXK) 

- the "fast files" for NOS/VE deadstart tCNIMAGE* 
PPIMAGE* RGIMAGE) 

- the command files needed for NOS/VE deadstart 
(CMDS1. CMDS2# CMDS3) 

■- the Remote Host binaries to be SYSEDIT*ed into 
the system at the current level {RHLQEP* RHLQSO* 
RHIQQQ, RHLPFP* RHLPSO) 
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- the procedure to SYSEDIT the Remote Host 
binaries IRHPRGCS) 

- the current CYBIt compiler (CYBILI) 

- the CYBIL II object library CCYBIILB) 

- the CI object file used to create CYBIItB 
CCYBILGO) 

- OSLPI 

b> LOADPF's the latest system into the INT1 catalog 
from the DUHPPF tape mounted on Unit 
{NT,D*PE,F*SI,iB*KU. 

c) Purges the old "fast files" from the last INT1 
system* 

d) SYSEDIT's the newest level of Remote Host into the 
system. 

5) Bring up dual states 

X.UPMYVE<CAT«INT1) 

K,n. (where *n" is the UPMYVE control point) 

6) Test if paging I/O is working! 

K. DECLARE P POINTER. 

K.SHOPEN P. 

K.CM P *1234*. 

K.MMWMP P. 

-> Disk unit light should flash on 844 Unit 1. 

K.DM P 100. 

~> If system is hung at this point then paging is 

not working. 

K.SMCLOSE P. 

7) Bring up A170 Remote Host? 

X.IRHF170. 

8) Bring up C180 Remote Host? 

K.EX RHINPUT,,A. 
K.EX RHGUTQ8,,A. 

9) Test input file route / job exit / output file routes 

X.DIS. 

USER,INT1,INT1X. 

GET, REGTEST,TESTBAM, JOB 1,408 2. 

ROUTE, REGTEST,DC*LP,FC*RH. 

ROUTE, TEST BAM* DC»LP,FC«RH. 

ROUTE, J0B1,DC«LP,FC«RH. 

NOTES J0B2 uses the output of JQB1 in Its execution! 
hence J0B2 cannot be ROUTE'd until JOB! finishes. To 
determine when J0B1 is finisheds 

Hit w * w key to return to K-di splay. 
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The J081 dayfile will be displayed as the Job is 
running. When the system has executed the JMEXIT 
statement* JOB1 has finished. The JOB1 dayfile will 
then be staged back to the 170 side to be printed. To 
pr int f i I es# do J 

- Hake sure the printer is on {i.e. the START light 
is lit). 

- F0RM32,TM. 
0N32. 

<The dayfiles of the REGTEST, TESTBAM* and JOB2 jobs 
Hill also be printed when these jobs finish.) 
Now J0B2 can be submitted* 

- Hit "*" key to return to DIS. 

- ROUTE* J0B2,DC*LPfFC*RH. 
DROP. 

The J0B2 dayfile will be displayed as it is running. 
When J0B2 finishes (JMEXIT has been executed) do a 

K.EX ZDIS**A. 
to return to the system job. When all jobs have 
finished executing and their dayfiles have printed - 
i.e. the commands 

K.JMSTATUS REMOTE EX. (lists jobs executing) 

K.JMSTATUS REMOTE PR. Uists jobs in print queue) 
return the status "NO ENTRIES FOUND" - then NOS/VE and 
Remote Host may be terminated by doing the following! 

n.DROP. <wbere w n« is the IRHF170 control point) 

K.+BYEVE. 

10) Bring down A170 NOS* 
AB, 

CHECKPOINT SYSTEM. 

E*M. Cmake sure that all checkpoints complete) 
STEP. 
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Or i gi nator _ .. ..., ... DATE ./ / . Tar get B« i 1 d _ 

Code Location J (£A£i<ed Modsets) FN*. , .. UN* ., ... 

(Decks in "£££]!£* format) FN* . UN* ... 

<2) Description File? FN*., „-_„. UN* ... 

Code Destination (if no.1 NOSVEPD* PL* ... ... 
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(3) QSLPI or Internal Interface changes required? t 3 
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The purpose of this form is to initiate a mini-build of the 
requested changes into the current build level* The scope of 
the changes requested and the impacts of making these changes 
must be adequately described* This is the only way to make 
changes to a system after the feature code cutoff for that 
build has occurred* 

££flU£S.lfi£* Name of the person submitting the change* 
J2.&JL&* Date of the request* 
£SR-.MilSLk££* Number of PSR being fixed* 

S/N . IQI ..System* Change affects the closed shop NOS system* 

Integration Catalog* A correction is necessary to the INT1* 

INT2. DEVI, or A170INT catalogCs)* 

UiHlfe*JLJU)£_iiI!5Z££' Change affects only the Virtual State 

execution of NOS/VE* 

l£^^l*JLUa«--££il££liil£J&£* A correction to the existing 

Installation Procedures is necessary Ue* such as moving a 

module to a different library) 

J > r,QQ?yct.,.S§t* Change affects an assembler or compiler* 

I£_££S±iLil££j(LiliS£4L.S.u££5 Change is necessary to the systemfs) 

provided in the S2 lab* 

SES Toojs* Some change is necessary to the SES tools used to 

generate systems Cie. Linker* Loader* Simulator* etc.). 

A11Q &&S SxsLsi* A change is required to the A170 Version of 

the NOS operating system* 

£Mal~S.iaJt£-£££££S ! Change affects the Dual State software* 

££ili££l~LL& * Fixes a problem which cannot be avoided either 
operationally* or programmed around* 

&aJfli £S£ 8 A serious problem for which a PSR exists and is a 

considerable nuisance to system users* 

£.£Jb££ s Fixes to nuisance* or time wasting problems* 

HQflset_Ident jf fees* Name of the modset(s) which need to be 
added to the affected software. 

jQe.£&s „ flgdi f i ed: Name(s) of module! s) which require 

recompi I att on or assembly as a result of this change* 

JteM£i£iJjm-Jil-££afei£ffl « A description of the severity of the 
problem being fixed* and the scope of the changes caused by 
integrating this change* 

A££££X3l* Authorization signature for the change* currently 
requires T.C* HcGee approval for NOS/VE* and 4.M. Graffius 
approval for A170 NOS. 



Advanced Systems Integration Build Activity Matrix 



CI 
09/17/80 



I NOS 
I Bui 

» 



/VE 
Id 



NOS A170 I S/81d Cy; 2 Start 

Bui id J Freeze 1 Bui Id 

i Interfaces? 

t ; <o/s) 

4 2 J 4/25 



4— 












J 

4- — 



+ 



% K 




6/3 



6/10 



.+ 






(0/S) 

6/16 



+ 



CQ/S) 
7/14 



J 7/16 



6a 



\ 7/23 

<0/S) 

8/18 






8/28 



9/4 













10/16 



11/19 



6/24 



8/6 



9/18 



10/30 



12/2 



PSR 

Code 

Cutof 



4/25 
7/4 



.+—, — 

* Com 
I Bui 



P 1 e t e 
Id 



0/S) 
/l 



S X®it to 
J SVLO^S, 
S TTOFAC 



6/16 



7/14 

8/18 









8/18 
9/29 



11/3 
12/12 






I 7 

4. ~. 

; ( 

J 6 

* — — 
i 

5 7 

+— — - 

8 
+__ 

J < 
I 8 
♦——— 

1 1 

♦- 

3 1 

+ 

J 1 



/9 

0/S! 
/20 




! Return 
* from 
\ SVLQP5 



6/2 



Compl ete 
8CR 



6/4 



0/S) 
/18 

/21 

0/S) 
/22 



• 
* 




a 
* 


6/23 


* 

4 




* 


7/21 




-♦ 



8/26 



* — 



8/26 




Files maintained by Integration 
Source Files 



01 
09/17/80 



? USER 
,' NUMBERS 



INT1 
DEVI 







INT1 
DEVI 



INT1 
DEVI 



VE17QPL 



A170INT 
LIBRARY 






? INT2/INT1 
5 DEVI 



INT1 
DEVI 



INT1 
DEVI 



INT1 
DEVI 



FUNCTION 






NQSVEPL 



— + 



OSLPI 



MADIFY program library 
of NOS/VE Program 
Interface decks* 

MADIFY program library 
of NOS code which 
supports NOS/VE. 



A1700PL 
OPL 






PROCLIB 



NOSLIST 






MTRLCB*EIELCB* 

EILCB*STSLC8 

LIBLCB 



NEWDKPL 



VERSION/FREQUENCY OF UPDATE 









MADIFY program library 
of Virtual State code 



■•♦— 



MOD 
whi 
sys 
CIn 
uni 

Com 
Pro 
(Do 
Int 
ure 



IFY progr 
ch matche 
tern level 
stalled o 
t 43), 



am library 

s NOS 
for S2* 

n FMD 






Con 
ass 
all 
cod 
LIS 



mand Lang 
cedure Li 
cumented 
egrati on 
s Noteboo 

tains com 
embly lis 

Virtual 
e. Acces 
TNVE proc 



uage 
brary 
i n 

Proced- 
k). 

pi lat ion/ 
tings of 
State 
sed via 

edure* 









Linker directives files 
for monitor* 
error interface* 
task services* and 
user modules 
r especti vely* 



Mea 
pro 
whl 
sub 
as 



ning! ess 
gr am I i br 
ch users 
stitute f 
an a I tern 



Madify 

ary 

may 

or 

ate 



Matches the level of system 
binaries contained in same 
catalog* Updated on periodic 
scheduled basis* 

Matches the level of system 
binaries contained in same 
catalog* Updated once for 
each bul Id cycle* 

Matches the level of system 
binaries contained in same 
catalog* Updated on 
periodic scheduled basis* 

Updated on a scheduled basis* 
tCPUMTR which supports NOS/VE 
is on VE170PL and &a£ 
on this PL)* 



•—♦ 



+ 



— ♦ 



Matches the level of system 
binaries contained in the same 
catalog* and accesses the 
appropriate build tool 
versions* Scheduled updates* 

Matches the level of system 
binaries contained In the 
same catalog* 



.— ♦ 






Matches the level of 
system binaries contained 
in the same catalog* 
EI is bull t using the 
BLDEI procedure* while 
N0S8ILD is used for EIE. 









Never* disappears when SCU 
conversion is complete* 
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base when using 
Integration compilation 
procedures* 



INT2/INT1 
DEVI 



NAP offset K 



INT1 
DEVI 



+-~ 



INT1 
DEVI 

\ DEVI 



~+- 



\ VQLTST3 



LDR_offset_K 






J KEYDESC 



Contains fink map of 
Dual State system 
created* where MAPOK 
Is a standalone NOS/VE 
system and MAP256K 
i s a 256K NOS Dual 
State system* 



Contains simulator 
commands for a 
batch mode test 
of the NOS/VE 
system* 






Con 
di r 
Sta 

Con 

the 
pro 



tains V€ generator 
ectives for Dual 
te offset loads* 



Each Velink of a Dual 
State system* 



.+— . 



— ♦ 



1 As required by system 
content changes* 



tains Keypoint 
criptions for 

Keypoint report 
gram XXM7KEY* i 



As required by system 
content or structure 
changes* 

Non-standard* updated 
upon developments request 



™— ♦ 
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— -*- 






INT1 
DEVI 



INT1 
DEVI 



XLMMTR 



XLJ11F*XLJ12F 
XLJ13F*XLJ1FF 



— + 



INT1 
DEVI 



INT1 
DEVI 



INT1 
DEVI 



* — - 



INT1 
DEVI 



INT1 
DEVI 



XOLG*XSCL* 
XLLMCII 



XUCNTL*XUT€ST* 
XUSORTvXUUXERl* 
XUUTL*XUVLEX# 
XUVLEX2 



Object text 
of modules w 
execute in a 
node* 

Object text 
of task serv 
modules whic 
job mode nit 
ring attribu 
11F*12F,13F 
IFF respect! 

Object text 
of the Objec 
Generator* S 
Command Lang 
and Object T 
converter* 

Object text 
of user test 
programs add 
to the syste 




— _ + 



MTRXOST* 
STSXOST* 
EIEXOST 



STSX101 
STSX118 



thru 



MTRX101 
MTRX105 



thru 



file 

hi ch 
oni tor 



f i les 

ices 

h run 

h 

tes 

and 

vel y* 



in 



Each recompi lation of a 
monitor mode module. 



Each recompi lation of 

a task services 

module within these libraries 






f i les 

t Library 

ystem 

uage* 

ext 



f i les 

ed 

m. 

which 
i tor* 
s» and 
ace 

S» 






MTRXHDR* J Header files 
STSXHDR* * name the ion 
EIEXHDR* 3 task service 

error tnterf 
segment file 
produced by 
VELINK* 

Outboard symbol 
t ab le f i I es for 
monitor* task 
services* and 
error interface 
produced by 
VELINK* 



The task services 
segment files 
produced by 
VELINK. 



The monitor 
segment files 
produced by 



««.+ 






Each recompi lation of 
these utilities* 



Each recompi lation of 
these tests 



Each Vel ink of the 
system. 



Each Vel ink of the 
system* 



r~— — ♦ 



+ — 






Each Vel ink of the 
system* 



,~+ 



Each Vel ink of the 
system* 
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VELINK. 



: inti 

J DEVI 



I INTI 
5 OEVI 



1 EIEX101 

2 EIEX102 









—4. 



thru 









2 XCPUMTR 



The error inter- 
face' segment 
f i I es produced 
by VELINK. 

A170 NOS CPU 
Monitor module 
binar i es. 



INT2/INT1 
DEVI 



I L€B_offset_K 



The Virtual Envir- 
onment f i le pro- 
duced by VEGEN. 



Each Vel ink of a 
Dual State system. 






Each r ecompi I at i on due to 
modset corrections or 
changes to the base A170 
NOS level system* 



+-- 






INT2/INT1 
DEVI 



The checkpoint file 
from the last 
simulation run as a 
result of running 
the VQLTST3 test 
commands* 



Each VEUNK/VEGEN 
of the system. 

S. Each batch mode simul- 
ation of NOS/VE. 



5 INT2/INU 



DEVI 



2 CKPTO 
2 CKPT2 






thru 



The simulated disk 
f I les produced 
during the batch 
mode simulation 

run. 



+. — 

Each batch mode simul 
ation of NOS/VE. 






2 A170INT 



2 NOSTEXT 



A170 NOS system 
text for current 
NOS version. 






DEVI 



2 XXM7KEY 



2 XXM7DSI 



Program to report 
NOS/VE Keypoints 
encountered during 
a simul ation run* 

Standalone version 
of NOS/VE deadstart 
file generator • 






2 DEVI 



2 DEVI 



2 INT2/INT1 



J XXDSGEN 



2 XIDST.XIDSK, 
5 XIDSP#XIHLP. 









TP_of fset_K 



Dual State 
deadstart fi 1 e 
generator. 

CYBER 180 PPU 
programs. 



Dual State 






— ♦ 



Each A170 NOS update 



* 
* 



Non-standard ISWl 
utii ity. 



Non-standard* 
unsupported. 

Upon demand. 



Upon demand. 



— — * 



- — ♦ 



Each time a new 
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deadstart f i I e 
created by the NOSSYS 
procedure. 
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deadstart 
generated 
demand}* 



file is 

(upon 
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This paper represents the beginning of a 'helpful hints on how to 
do your job's document. Some of the areas discussed are still 
incomplete* I will be periodically adding information to the 
document. If you have any qustions or suggest ions* pf ease see Tom 
McGee. Appendix A lists background documents and how to obtain 
them. 

Date Changes 

2/8/80 Section 3.0 revised 

2/12/80 Appendix A Section 3.3 corrected 

2/13/80 Section 1.0 revised 

9/11/80 Section 3.5.2.8 revised* Section 3.5.2.8.4 added 
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£1*0 DOCUMENTATION FOR RUNNING ON S2 



£1.0 JlI3£iUl£tlIAIIQlLJ£fl&-&ilJiHIMfi-fllL.S2 



El.l SIAMflALIMULJiOSm 
Topi c 



Document 



1. Standalone NOS/VE HW/SW 
Conf i guration 

2. Integration Procedures Notebook 
Bui Id Procedure 

3. Deadstart Panel Settings (Real 
Panel* CMSE Emulated Panel) 

4. Standalone Deadstart Procedure 

5. Standalone CC545 Operator 
Console Interface 

6. Debug Mode Interface 



On bul letin board 

in S2 area 

NOS/VE User's Guide - 

Appendix A 

On deadstart panel 



7. Standalone Dump to NOS/VE Printer 



8* How to Analyze 

9. What To Do If* 
o NOS/VE abort 
o NOS/VE hung 
o Can't deadstart 
o HW errors 
o Unrecovered disk 

etc. 

10. Detailed Documentation 
11 • Patching Memory 



JFS Paper - Section 
NOS/VE User's Guide 
Appendix A 
NOS/VE User's Guide 
Appendix A 
NOS/VE User's Guide 
Appendix A 
a Standalone NOS/VE Dump 



2.0 



errors 



for EC 





JFS 
JFS 
JFS 


Paper - 
Paper - 
Paper - 


- Section 

- Section 

- Section 


2, 
2, 
2, 


.0 
.0 
► 


egi 


ster CP 


lac hi ne 


Dependent) 
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1. Dual State NOS and NOS/VE 
HW/SH Configuration 

2. Dual State NOS/VE Deadstart 
File Bui ding Procedure 

3. Deadstart Panel Settings 
(Tape and Disk) 

<f. NOS A170 Deadstart Procedures 



On bulletin board 
in SZ area 

Integration Procedures 
Notebook 

On deadstart panel 

KMJ Paper - Section 3.1 
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£1.0 DOCUMENTATION FOR RUNNING ON S2 
El. 2 DUAL STATE NOS AND NOS/VE 



5. NOS Operator Command € NOS Operator** Guide - 
Display Interface Appendix A 

6. NOS DIS Interface NOS Operator's Guide 

Appendix A 

7. NOS 026 Interface NOS Operator's Guide 

Appendix A 
8* CTS Interface (Simulated TELEX ASCII Terminal 

from Operator Console) 
9. Dual State Initialization <UPV£)« WHB Paper - 

Operation (RUNVE) and Section 3.3, 3.5 

Termination CTRMVE) 
10* UPVE Command File Format (Configuration* Memory 

Patches* NOS/VE Commands) WHB Paper 

11* MCU (DKD) Commands and Displays WHB Paper 

12. K Display Operation of NOS/VE WHB Paper - Section 3.4 

13. NOS Error Messages NOS Diagnostic Handbook 

Appendix A 

14. LOADPF/OUMPF to Move PF's Between SN101 

and S2 (Non standard) KMJ Paper-Section 3.1 

15. How to Analyze a Dual State Dump 

16. What To Do If? 
o NOS abort 

o NOS hung 

o NOS unrecovered disk errors 

o NOS detected HW errors 

o Screens blank 

o NOS/VE abort 

o Can't deadstart NOS 

17. CMSI/CTI Disk Pack Build Procedures 

18. Installation Procedures Integration Procedures 
for New EI Notebook 

19. Installation Procedures for Integration Procedures 
New NOS Dual State Notebook 

Stuff (SYSEDIT UPVE and Friends) 

20. Debug Mode Interface NOS/VE User's Guide - 

Appendix A 

21. MODVAL - Add New Users KM4 Paper - Section 3.1 
or Change Validation 



E 1 . 3 SQItLH MCA U2M£~ 4*m-JH2AL-iI!I£ 

1. General Use of CMSE (ODDD, WK, DP, etc.) 

2. EDD (CTI) Dead Dump Procedure DAH Paper - Section 3.6 

3. DSDI Commands and Procedures for DAH Paper - Section 3.6 
EDD Dump Interpretation 

4. Reload/Restart Microcode Procedure 
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El. 3 BOTH STANDALONE AND DUAL STATE 



5. NOS/VE Error Message list NOS/VE User's Guide 

Appendix A 

6. Keypoint Usage and Trace NOS/VE User f s Guide 
Analysis Appendix A 
Simulator keypoints Integration Procedures 

Notebook 

7* Dead Dump to Printer Procedure Using ODDD 

8. Use of Trace Information Currently Kept by NOS/VE CPMTR 

9« Error Halt Addresses 



El. 4 QIiJ££ 



1* Things "not to do" 

Zm Phone #s on machine* CE*s office* etc* 

3. Door lock combination #253 

4. Location of tapes and disks HOC Paper-Section 4.0 

5. Who to call for assistance 
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€2.0 m JiDALJ3M£_MQS^£-££££3IA£I 



E 2 . 1 S£M£RAi-£RI]££J}y££-£QE^fi£AnilAEI^iQ^£OI£Il 

1, Mount deadstart tape 

* 2* make sure microcode (firmware) is loaded into the 92$ 

tape controller and disk controller. 
3* Mount scratch packls) on HCS disk drivels)* 
4* Press deadstart button. 
** 5* Make sure PZ DEC register and M2 BR (bounds 

register) are set correctly. 
6. Start CPU running 
7a. Verify proccessor is running 
OR 
7b. Take dump of memory. 

* usually not necessary 

** not necessary except on 1st deadstart 

E 2 . 2 D£IM££IL.££IH:£I}U££^£i3£-lIAHfi=AU2H£^Q£liiSIA&I 

1. Mount deadstart tape 

o mount on UNIT (other units can be used if location 5 of 
the deadstart program is set appropriately. See step 5). 

2* Set up the deadstart panel for CTI deadstart from disk*. 

o use the *DISK deadstart* snitch setting. Switch settings 
are pasted to deadstart panel* 

o the channel-£q-Uni t setting of the deadstart program must 
reflect the location of the CE pack referred to as f ARH 
Regression 1 disk* The disk should be mounted on Unit 4. 

3. Mount the scratch pack(s) on the NOS— V£ disk drivels). 

o currently the OS is set up to run with 1-doubte density 

disk on unit 1* This can be changed during deadstart 
o use the pack labeled *HCS scratch 1 

4* Make sure microcode is loaded in the P2. 

o IDS) Press deadstart button. You should see a display that 
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says J 



(CR) - OS load 
- Deadstart auto 
U - Util 
M - Maint 



If not* check deadstart 
panel* disk unit* Try 
long D.S* seq* Reconf 
PP's* Load disk cntrl 
•♦ cntrl ware* 



Type *M»* This causes another display to appear 

Type MCR)» 

At this point it is sometimes wise to preset memory* Type 

KC 0* 100000* eeeeeeeeeeeeeeee CCR) 



and wait until 

to 20 seconds* 

Type *GQ INSTRN CCR)** Wait 

static* Takes 5-10 seconds* 



lower left of display is static - takes 10 

until lower left of display is 



Now you are ready to deadstart 
will start with this step* 



NOS/VE* Subsequent deadstarts 



(DS) 
Type 
Type 
Type 



deadstart button 



settings appear 

unit number of the deadstart 

the screen 
moving* If not* 



Press 

, DSTCCR) i deadstart panel 

*5*12u*(CR)* («u» is the 
tape») 

Type MBKSP) 1 3 times to clear 
Type MCR) 1 Tape should start 
o check unit 
o go back to step 4 
o try another tape 
o call for he lp 

6. Message •PROCEED* should appear on the screen* At this point 
all NOSVE ?P code has been loaded* processor registers are 
loaded and central memory is loaded* 

o If tape moves a lot but •PROCEED* doesn't appear* call for 

help* 
o Type •DR*P2CCR) 1 * If the value of the SIT is changing* all 

is well* If SIT is not changing* repeat steps 3* 4* 5* If 

it still isn»t changing* call for help* 

7. If this is the first deadstart since a non-NOSVE user used the 
machine* make sure the P2 EC register and the M2 BR register 
are set correctly* 

o Type *DR*P2(CR) , « This brings up a display of P2 registers 
o Type ILEx£2jL£51*Ofi££«fiJ2flfi-iia£-600fi <CR)«* You should see 

the value being displayed for the EC register change to the 

value specified above* 
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o Type , DR*M2{CRM. This brings up a displayof M2 registers 
o If any register has a non-zero value In it* set it to all 
zeros* 

8. At this point hex patches can be entered from the console or 
card reader to fix software problems or to change the values 
of system constants* If you are lucky you can skip this 
step. Patches which may be necessary are? 

o CF* 2028*X000 0000 0000 0006 where X specifies the unit 
number of the disk(s). <X*8 for unit 0* X*4 for unit If 
X*2 for unit 2* X»l for unit 3* X*3 for units 2 and 3. 
etc. ) 

o CF*2020*0000 OOXX 00mm 0000 where mm « amount of memory to 
use in hex megabytes. Default is 2. The value of the XX 
field must not be changed from what Is initially there* 

9. Type f SS<CR)» to start the CP running 

10. Type »DD(CR)« to look at the dayfile for the system job. 
Values in the header should be changing. 

If the display header is changing* all is well. Go to step 

11. Otherwise either hdw or sw is broken. 

Type «DR»P2 CCCR) •• 

o If PFS* CELO* CEL1 are non-zero* its probably a hardware 

pr ob I em 
o The value of P will indicate where you got to in software 
o Type *DR*0 (CR) f . Location of CM contains the XP that 

was executing when the processor halted. The XP dumped to 

loc does ajai contain Pi i.e.* word is AO. Look at the 

MCR/UCR. 
o Type « DR*M2(CR). If UC01 or UC02 are non-zero* its 

probably a memory problem. 

11. You are in the idle loop. Type some commands* CSame commands 
you type If on the simulator. Additional commands processed 
by the PP are also available.) 

E2.3 MS*_£MJ.ES 



The system cannot handle all disk errors. If the CPU halts* you 
can determine if the halt was caused by a disk error by doing the 
following: 

o display location 2008 
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o The left half of this word contains the RHA of the mtr halt 
msg that describes the reasons for a ^ojjml.axi monitor 
halt. If monitor did not voluntarily halt* word 2008 will 
contain 000AO0FEG7D00O0, (approx) 
o Display the location pointed to by location 2008 lleftl. 
o If the location contains 

xx 73713031 . .. (ASCII for ppSQOl - 3* where p is a 
descriptor for the string) 
then you hatted because of a fatal disk error, 
o The cylinder* track* sector of the bad spot is in the 2nd 
word of the message pointed to by toe 2008. Word 2* 3 
contains 

xxOO OuOO ccOO ttOO 
ssOO 0000 0000 0000 
where 

u * unit number tt - track 
cc - cylinder ss - sector 
o To 'down* the bad spot* after each deadstart* TYPE 
FMDOWNAU u c t s 
u ■ unit 4-1 from halt msg 

c*t*s * dfiiiiiaJL representation from halt msg* of cyl* 
track* sector. 
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E 3 . WIAL-SI AI£.MQSZ^£-D£ MSIABI 



E3.1 A1Z*LMQ5JB£AJ2£IMI 

1) The system is configured to run with three FMD units (41* 42* 
and 43). No 844 drives are needed. 

2) Turn off all 844 disk drives* Leave the EHO devices on* 

3) Set the D/S panel to deadstart from the primary system disk 
(CH*1* Unit*41 or 43. See console or bulletin board for a 
description of which h disk contains the primary system* 
Set the D/S panel word 14 to RPXX 

where R * D/S level CO or 3) 

P * 1 if you wish to see the CNRDECK* P « if not. 

XX = CMRDECK number 
For the first deadstart in a session use **0006** 
Set word 16 to 00001 

4) Push D/S button 

5) Select W W display and then select "H" display 

6) Set **CS • NO" only if you don't want microcode to be loaded* 

After the initial deadstart* loading microcode lsn*t 
necessary* 

7) Enter a "backspace* 1 

8) Select W P M display 

Here you may set W I*3 W for recovery level deadstart 

(Use 1*0 for first deadstart) 

Set M D*Y*» to see CMRDECK* This may be needed if you wish to 

see or to change the current system configuration* 

9) Enter "(CR)** and the system should deadstart* You should then 
enter the date and time when the system displays these 
requests • 
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o FHD Unit 43 

This unit contains the following? 

- A170 NOS. CTI, CMSE* EI binaries <N0S deadstart files) 

- Files associated with user number LIBRARY 

- Files associated with user number SES 

o FHD Unit 42 

This is a scratch unit* 

o FMD Unit 41 

This unit contains the following? 

- A170 NOS* CTI, CMSE# EI binaries (NOS deadstart file) 

- Files associated with user number DEVI 

- NQS/VE Development Area PL f s and Member PL f s 

- NOS/VE Deadstart Files to be tested (saved in individual 
user's catalogs) 

£3-3 Mi AL-SI AHUJiQ£_Q£ERAIiaii 

1) The convention used for creating user numbers on NOS/VE is as 
f ol I ows J 

o Your user number will be your initials* 

o Your password will be these 3 letters followed by the letter 

»x«* 
o You must see Integration to be assigned a user index 

User numbers are created by executing the program M M0DVAL H as 
fo i I ows: 

o Type "X.MODVAL". 

o Type w K*m* w where m is the MODVAL control point 

o Type M K*C»uuu« M where uuu * your user number* Note that the 

M K* W stays on the screen* 
o Type **K*PW*uuuX* FUI«n* M where n * your user index 
o Set all other parameters to their maximum values* Do a w *° 

to see next page - there are 3 pages associated with a user 
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number, 
o Type "K.END*** to end creation of that user number* Another 

user number may now be created. 
o Type "K.END." again to exit HODVAL. 

2) PF dumping and loading 

You may use W S£S.DUMPPF W on SN/101 to dump your permanent fies 
to tape* and then load them onto your user number on A170 NOS 
using H SES .LQADPF H . Documentation on ho* to use these SES 
procedure and what their parameters are is included in the SES 
"User's Guide* or they can be obtained by typing: 

"SES*HELP.DUMPPF H and "SES*HELP.LOADPF w . 
£3*4 aOSm-M AMIARI 

1) The following file must be available in your catalog on the S2* 

TPXXXK contains a NOS/VE deadstart image* This must be a copy 
of the dual state deadstart images available from the link 
procedures. 

CMIMAGE* PPIMAGE* RGIHAGE are "fast" files* which are built 
from TPXXXK the first time you deadstart NOS/VE. These files 
are then used on subsequent deadstart attempts. Before a new 
TPXXXK can be used* these "fast" files must be purged off your 
user number. 

2) Place a SCRATCH disk on 844 drive number 1. 

3) Type X*UPMYVEICAT*uuu) where uuu is your user number. 

4) The UPMYVE job will display the following! 

REQUEST *K* DISPLAY on the B display 

Type K»n* where n is the control point number of the UPMYVE 
job. 

5) Type K.*PPLOAD«TRUE* if you want to load and use disk 
drivers. Default is no driver. This Is a reminder to perform 
step 2. This must be entered if you wish to buid the fast 
files mentioned in step 1. 
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61 Type K.*RUN. Note that the deadstart that creates the fast 
file Mill take 1—3 minutes to complete. After the fast files 
are built* it usually takes about 30 seconds* 



E3.5 Mflm£_flE£fiAI10J!l 

E3.5.1 COMMUNICATION WITH A NOS/VE JOB 
E 3 . 5 . 1 . 1 AoiL„Q&xtil§Ub i£R±a& 

Type 

K«EX ZDI58..A. 

where n is the number of the job. 

To bring up the NOS/VE W B W display* enters 

K**VEDISPLAY*CP. 

To return to the NOS/VE dayfile display* enter* 

K.*VEDISPLAY*DAYFILE. 

E3.5.1.2 !sajlins_£ojQja!ig:s 

Type 

K.n«XXX* 

where n is the job number and XXX is the NOS/VE command* NOTE* 
XXX cannot contain periods* 

E3.5.2 USING THE REMOTE HOST 



The 180 side of the remote host is included in Build 6 of NOS/VE 
and subsequent builds* To use it* NOS/VE must be up and running. 

To initiate the current NOS/VE build, type X.UPMYVECCAT«NV€>* 



E3-5 
S2 Machine Usage Document 

09/17/80 



€3.0 DUAL STATE NOS/VE DEADSTART 
E3.5.2 USING THE REMOTE HOST 



The 170 side of the remote host is included in the NOS 170 
system at deadstart time. 

E3.5 .2 . l £tina_U£_£H3^fflm£_Hi2ai 

Type 

X*IHRE170. 
€ 3 * 5 . 2 . 2 a£iBS_y£_£I£Q_££ffifli;£-Hils£ 

Type 

K.n* where n is the UPJ1YVE control point number* 

K.EX RHINPUT..A. 

K.EX RHQUTQ8>,A. 

RHINPUT is the 180 task which receives job input files from 

the 170* 

RH0UTQ8 is the 180 task which sends print files to the 170* 

£3.5,2*3 EflMi£.Afl-Ia£Ut-£llfi-££.ai-.iI12fi-Ifl^£lfijQ 

Through the system console* enter* 

Type 

X.DIS. 

USER.A.B. 

GET»f i I enane* where filename 

identifies the input file to 

be routed* 
ROUTE.fi I ename. DC »ll».FC*RH. 

If you are running from an interactive terminal* enter* 

GET.fi I ename* 

R0UTE.fi lename.DOLP.FORH. 

The input file which is sent to the 180 must be in Display Code 
<64 character set - upper case only). The job file must be a 
single partition 170 record contaning NOS/VE commands* Multi 
partition input files sre not yet supported by NOS/VE so 170 data 
files used by the program must be obtained through the NOS/VE 
permanent file GET command. The last command of the job file must 



S2 Machine Usage Document 



E3~6 
09/17/80 



€3.0 DUAL STATE NOS/VE DEADSTART 
E3.S.2.3 Route An Input File Froi 



C170 To C180 



be JMEXIT in order to cause the job to terminate properly. Support 
for ASCII job files (6/12 ASCII) will be added at a later build. 
The asterisk character should be used in place of the quote 
character to delimit parameters for the NOS/VE EX command. 



At N 

auto 

outp 

prog 

expl 

pr i n 

wi I I 

set 

ASCI 

NOS/ 

dl sp 

NOS/ 

cont 

vi a 



os/v 

mat i 
ut f 
ram 
iclt 
t fi 
be 
- up 
I Pr 
VE o 
lay) 
VE p 
ai ne 
the 



E jo 
call 
if e 

pr in 
ly r 
les 
conv 
per 
int 
utpu 
*i t 
r int 
din 
K di 



b te 
y re 
$0UT 
t ou 
oute 
must 
er te 
case 
f i le 
t fi 
h th 
f il 
the 
spl a 



rm in at 
turned 
PUT hi 
tput m 
d to t 

be wr 
d from 

only) 
s (8/1 
les wi 
e name 
e to t 

180 j 

y* 



ion the 
to the 
11 be ov 
ust be w 
he 170 w 
it ten by 
8/8 ASC 
when th 
2 ASCII) 
1 1 appea 
IRHFxxx 
he 170* 
ob file 



job 
170. 

QTMT 

ri tt 
ith 

BAH 
II R 
ey a 

wil 
r in 

as 
the 
or b 



log (da 

Data 
it ten b 
en to a 
the JMR 

as 8/8 
T«W to 
re sent 
1 be ad 

the 17 
a banne 
fol low! 
e enter 



yf i le) Hi 1 I be 
written to the NOS/VE 
y the job log so all 
Iternate files which are 
OUTE command. NOS/VE 

ASCII RT*W. Print files 
Display Code (64 character 

to the 170. Support for 
ded at a later build. A1 I 
output queue (NOS H#0 
r* In order to route a 
ng command must be 
ed from the system console 



JMROUTE* jobname*f i I en am e* PR > RE MOTE 



jobname - name that the print file will have in the 180 output 
queue. 

filename - name of the local 180 file created by BAM that is 
to be printed. 

PR - specifies that the file is a print file (must always be 
PR). 



REMOTE - name of the 180 family for the print file Cmust 



always be REMOTE). The NOS command language 



HCS mode 
command. 



(HCS command) in order to enter the 



must be 
JMROUTE 



in 



Example of JMROUTE command* 

JMROUT£*LISTING*LINKMAP*PR*REMOTE. 

On the C170 side* the printer must be physically and 
logically on. To logically turn the printer on* under DSO 
enter s 
QN32. 
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F0RM32*TH. Cln honor of our illustrious leader* Tow 
McGee) 

E 3 . 5 . 2 . 5 iJU!IK-US£&J£j»MIlil 

In order to access C170 permanent files from a C180 job* the 
NOS/VE job must issue a LINK_USER command. The LINK_US€R command 
specifies the user identification on the 170 under which C170 
permanent files will be accessed. 

The following must be done to enter the LINK^USER command* 

set. 

LIU*US*(user> f ami ly )• PA*password* A*account* PR*project. 

HCS. 

The SCL command puts the NOS/VE command processor into SCI 
mode* The HCS command puts the NOS/VE command processor into HCS 
mod {HCS mode is required for the GET and REPLACE commands). 

The LIU (or LINK_USER) command specifies the NOS user* family, 
password* account and project parameters which are used by IRHF170 
to create 170 jobs which access C170 permanent files. A NOS/VE job 
can issue only one LINK_USER command per 170 family* All LINK_USER 
parameters are specified with keywords and ail are requied. 

US <or USER) - This parameter specifies the NOS user number 
(catalog) and family in which the 170 permanent files reside, 
•user* will be the first parameter on the 170 job* s USER card and 
•family* will be the second parameter. Currently the only family 
on the S2 Dual State system is called NVE. 

PA (or PASSWORD) This parameter specifies the password that is 
used to login to the user number. •password* will be the 
third parameter on the 170 job's USER card. 

A or (ACCOUNT) This parameter specifies the account number 
(charge number) for the 170 job. It will be the first 
parameter on the 170 job's CHARGE card. 

PR or (PROJECT) This parameter specifies the project number 
for the 170 job. It will be the second parameter on the 
170 job's CHARGE card. 

Note: When running on the Simulator* the LINK_USER command is 
not required to use the GET and REPLACE commands. 
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Example of LINK_US£R commands 

SCL* 

IIU,US«{FAB*NV£)*PA*FABX,A«7136. PR«73E08802. 

HCS. 

E 3 * 5 • 2 . 6 &£l„&„lIQ„l&LMm&Rt-LiL&-ELm-l£LQ 

The GET command obtains a copy of a permanent file residing on 
the 170* The 170 permanent fife can be either a direct or an 
indirect access permanent file* The NOS/VE command processor must 
be in HCS mode (HCS command issued) in order to use the GET 
command* All parameters on the GET command are positional* Only 
the »lfn* parameter is required. A LINK_US£R command must be 
issued {for the 170 family on which the permanent file resides! 
prior to issuing the GET command* The format of the GET command 
is: 

G£T*lfn.pfn.pw*un«fm»cd* 

Ifn {local file name) - This is the name of the local NOS/VE 
file to «hich the 170 permanent file will be transferred* 

pfn (permanent file name) - This is the name of the 170 

permanent file that is to be accessed* If this parameter is 

omitted then f lfn» will be used for the 170 permanent file 
name* 

pw (password) - This is the password that will be used to 
access the 170 permanent file if a password is required to 
access the file on the 170* 

un (user name) - This is the user name (alternate catalog) on 
which the 170 permanent file resides* 

fm (family) - This is the family on which the 170 permanent 
file resides* Currently the only 170 family on the S2 Dual 
State system is NVE* 

ca (conversion alternatives) - This parameter specifies the 
type of conversion that is performed by the IRHF on files 
transferred from 170 to 180* If this parameter is omitted 
then a default of 860 will be assumed* Values for this 
parameter are* 

860: Basic Biary 
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The full 60 bits of each 170 word are transferred to the 
lower 60 bits of each 64 bi t 180 word* The upper 4 bits 
of each 64 bit 180 word zre set to 0* The file is written 
to 180 using BAM with Block Type * System (Unblocked) and 
Record Type * Undefined (RT*U) so no control information 
is Inserted in the file* The 170 logical record structure 
is dropped (i*e*# EORs are deleted causing the logical 
records to be packed together* 

856S C180 Binary 

The lower 56 bits (7 8 bit bytes) of each 170 word are 
packed into contiguous 8 bit bytes on the 180 (i*e*« 7 8 
bit bytes from the first 170 word and 1 8 bit byte from 
the second 170 word go into the first 180 word etc.). The 
170 logical record structure (EORs) are dropped* The way 
that the 180 file which was transferred from 170 is 
accessed should correspond to the method used to create it 
on the 180 originally (assuming that the file originated 
on the 180)* 

A6: 6/12 ASCII 

A170 6/12 ASCII character files (used by XEOIT and most 
SES utilities) are converted to 180 8/8 ASCII with Block 
Type * System (Unblocked) and Record Type * Variable 
(RT«W)* The 170 logical record structure EORs are 
dropped* 

A8s 8/12 ASCII 

170 8/12 ASCII character files are converted to 180 8/8 
ASCII with Block Type » System (Unblocked) and Record Type 
« Variable (RT*W)* The 170 logical record structure 
(EORs) are dropped* 

064* Display Code 64 Character Set 

170 Display Code character files are converted to upper 
case 180 8/8 ASCII with Block Type » System (Unblocked) 
and Record Type * Variable (RT*W)* The 170 logical record 
structure EORs are dropped* 

Example of GET command* 

SCL. 

LIU,US«(FAB.NVE).PA«FABX*A«7136. PR-73E08802* 

HCS. 
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GET.T£XT,TEXT612,.*NV£,A6* 

Note? Hhen the GET command is used on the Simulator* the 
file specified by the , pfn t parameter must be a 170 
file which is local to the simulator Job. 

E 3 . 5 * 2 * 7 £££i^d£^_lia^£££iaB£Bi-£ii£^££iil.llfi 

The REPLACE command transfers a copy of a 180 local file to a 
permanent file on the 170* If a permanent file of the same name 
does not exist for the specified user (catalog)* a direct acccess 
permanent file is created* If a direct access permanent file of 
the same name already exists in the catalog and the file can be 
attached with write mode then the existing direct access file is 
overwritten with the file from the 180* If an indirect access 
permanent file of the same name already exists in the catalog then 
the Indirect access file is replaced by the file from the 180* An 
existing indirect access file will jxa£ be changed to a direct 
access file if the user's Indirect access file size limit is 
exceeded. The NOS/VE command processor must be in HC$ mode CHCS 
command issued) in order to use the REPLACE command* All 
parameters on the REPLACE command are positional* Only the *lfn f 
parameter is required* A LINK_USER command must be issued (for the 
170 family on which the permanent file resides) prior to issuing 
the REPLACE command* The format of the REPLACE command is* 

REPLACE* I fn.pf n.pw#un*fm. ca* 

Ifn {local file name) - This is the name of the local NOS/VE 
file which will be transferred to a permanent file on the 
170. 

pfn (permanent file name) - This is the name of the 170 

permanent file that is to be created or replaced* If this 
parameter is omitted then Mfn* will be used for the 170 
permanent file name* 

pw (password) - This is the password that will be associated 
with a newly created direct access file or which is used 
to gain access to an already existing direct or indirect 
access permanent file. 

un (user name) — This Is the user name (catalog) on which an 
existing 170 direct or indirect access file resides* This 
parameter is illegal if the file does not exist* 



fm 



(family) - This is the family on which the 170 permanent 
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file is to reside* Currently the only 170 family on the 
S2 Dual State system is NVE* 



ca (converion alternatives) — This parameter specifies the 

type of conversion that is performed by the IRHF on files 
transferred from 180 to 170. If this parameter is omitted 
then a default of B60 will be assumed* Values for this 
parameter ares 

B60* Basic Binary 

The lower 60 bits of each 64 bit 180 word are transferred 
to the full 60 bits of each 170 word* The upper 4 bits of 
each 64 bit 180 word are discarded* The 180 file which is 
to be transferred should be written by BAM with Block Type 
* System (Unblocked) and Record Type » Undefind (RT»U)* 
The file is transferred to the 170 as a singl e I ogi cal 
record <i.e. files with multiple EORs cannot be created 
on the 170 from the 180)* 

856? C180 Binary 

Groups of 7 contiguous 8 bit bytes from the 180 will be 
transferred to the lower 56 bits of each 170 word (i.e. 
the first 7 8 bit bytes from the first 180 word go to the 
lower 56 bits of the first 170 word, the 8th 8 bit byte of 
the first 180 word and the first 6 8 bi t bytes from the 
second 180 word go to the lower 56 bits of the second 170 
word etc.)* The way that the 180 file to be transferred 
is created does not matter because the entire structure of 
the 180 file is preserved on the 170* The file is 
transferred to the 170 as a single logical record* 

A6? 6/12 ASCII 

A 180 8/8 ASCII character file with Block Type * System 
(Unblocked) and Record Type * Variable (RT*W) is converted 
to a 170 6/12 ASCII file (used by XEDIT and most SES 
utilities)* The file is transferred to the 170 as a 
single logical record* 

A8s 8/12 ASCII 

A 180 8/8 ASCII character file with Block Type » System 
(Unblocked) and Record Type * Variable (RT*W) is converted 
to a 170 8/12 ASCII file. The 170 file can be routed 
directly to the printer with the 170 ROUTE command with 
the EC«A9 parameter* The file is transferred to the 170 
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as a single logical record* 

D643 Display Code 64 Character Set 

A 180 8/8 ASCII character file with Block Type * System 

(Unblocked) and Record Type » Variable (RT*W) is converted * 

to a 170 Display Code file with lower case characters « 

mapped to upper case* ASCII special characters that do i 

not have a Display Code equivalent are converted to 1 

Display Code blanks* The file is transferred to the 170 * 
as a single logical record* 

Example of REPLACE commands 

SCL 

LIU,US*CFA8.NVE)f PA*FA8X> A*7136> PR«73E08802. 

HCS. 

REPL ACE, HYFILE* FILE 856, ,,NVE.B56* 

Note? When the REPLACE command is used on the Simulator* the 
file specified by the f pfn* parameter will become a 170 
file which is local to the simulator job. ! 

£3.5*2.8 £*3IS£i£_ilLks_£e.££ejL£fliififl_^ 

General Notes 

o HCS command causes NOS/VE to switch to HCS command language 

i nterpret er 
o SCL command causes NOS/VE to switch to SCL command language 

i nterpr eter 
o Comment capability within command line is not currently 

aval I able 
o HCS comment line format < starts with single quote) not SCL 

compatibl e 
o The 860 conversion parameter on the GET command is utilized to 

indicate that the A170 file is to be transferred to NOS/VE 

without conversion 
o The NOS/VE job command stream must use display code 
o The B56 conversion parameter on the REPLACE command is utilized 

to indicate that the 64 bit oriented NOS/VE file is to be 

transferred to the A170 without truncation of data* 56 C180 

data bits are stored in each 60 bit A170 word* 
o The 856 conversion parameter on the GET command Is utilized to 

indicate that an A170 file with 56 C180 data bits per 60 bit 

A170 word are to be transferred to NOS/VE as a 64 bit oriented 

NOS/VE f i le* 
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€3,0 DUAL STATE NOS/VE DEADSTART 

E3*5*2*8 Example Jobs Representing Phase A/8 Library Creation/Modi 

o REPLACE cannot be used to replace an existing A170 file 

o GET and REPLACE do not allow specification of alternate user 

names. Use of multiple LIU commands with different families for 

each user catalog is a way to circumvent this restriction* 
o An asterisk should be temporarily used in place of the quote 

m ar k* 
o An 3 character should be temporarily used in place of the 

underline* 

E3*5*2*8*l CREATE OBJECT LIBRARY ON NOS/VE AND SAVE IT ON A170 NQS 
Notes 

o CLG0170 is A170 permanent file name for file containing object 

text <in CI data mapping) for modules to be included in the 

I ibrary* 
o CITEXT180 is NOS/VE local file name for file containing object 

text (in CI data mapping) for modules to be included in the 

I ibrary* 
o IITEXT180 is NOS/VE local file name for file containing object 

text (in II data mapping) for modules to be included in the 

I ibrary* 
o LIBRARY180 is NOS/VE local file name for the library being 

created* 
o ILIB170 is A170 permanent file name for file containing the 

I ibrary* 

NOS/VE Job Commands 

SCL 

LIU. USER»Uln,NVE),.* 

PASSWORD»jlnx,.* 

ACCOUNT *notused«*. 

PROJECT»notused 
HCS 

GET,ci textl80,clg0170.,,NVE,B60 
EX,CIT0II,*citextl80,i i text 180* 
EX, COL 

ADD, 08JECT_f=It£*ii text 180 
GENERATE, LIBRARY*! ibraryl80 
END 

REPLACE, librarylBO.i li bl70,,,NVE,856 
J ME X IT 

E3*5*2.8.2 MODIFY A PREVIOUSLY SAVED OBJECT LIBRARY 

Notes 
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o ILIB170 is A170 permanent file name for file contains the old 

I ibrary 
o II8RARY180 is NOS/VE local file name for file containing the old 

I ibrary 
o CMQD170 is A170 permanent file name for file containing CI 

object text for the new module 
o NEWCIMGDULE is NOS/VE local file name for file containing CI 

object text for the new module 
o NEWIIMQDULE is NOS/VE local file name for file containing II 

object text for the new module 
o NEWLIBRARY is NOS/VE local file name for the library being 

created 
NLIB170 is A170 local file name for new library 

NGS/VE Job Commands 

SCL 

LIU,USRM jln,NVE>,.. 

PASSW0RD»jlnx,** 

ACCOUNT»notused,.. 

PROJECT«notused, •• 
HCS 

GET, I ibrary 180* i I i bl7Q,,,NVE,8 56 
GET>newcimodul e# cmodl70,,, NVE, B60 
EX,CITOII,*newcImoduie,newiifflodu^e , 
EX, COL 

ADD, library* I ibrary 180 
REPL ACE, 08 JECT^FILE* new it module 
GENE R ATE, L IB RARY*new library 
END 

REPL ACE, new! i brary,n I i bl70,,,N VE,B56 
JMEXIT 

E3.5.2.8.3 USAGE 0E NOS/VE LOADER 

LIMITATIONS 

The NOS/VE loader is activated by the HCS version of the EXECUTE \ 

command* This causes some limitations to loader usage since the J 

HCS version of EXECUTE does not support all of the parameters 5 

(loader options in particular) that the NOS/VE version supports. • 

These limitations are detailed below* X 

Exactly one file must be specified in the object list. This 1 
file must be an object text file Cas opposed to a library * 
file), \ 

- Modules are loaded from libraries only to satisfy externals. J 
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Libraries to be used for this purpose way be specified by either 
the (SCL) command SET_OBJ£CT_LIST or directives embedded In 
object text being loaded* The library of task_ser vices entry 
points is al&ajfcs used to satisfy externals. 

- At least one module to be loaded must contain a CYBIL PROGRAM or 
the equivalent (i*e*» a transfer symbol must be specified)* 

- Load map options 8* E and S are selected by default* These 
selections may be changed via the CSCL) command 
SET_PRQGR ADOPTIONS* 

- The default error action is ERROR* This selection may be 
changed via the (SCL) command SET_PROGRAH_GPTIQNS* 

- The load map is always generated on the NOS/VE file named 
• loadmap 1 * 

- The program options STACK_SIZE AND PRESET are not supported* 

PROCESS 

Create an object text file by compiling a program in real state* 
Then perform the following steps in virtual states 

~ Use the (SCL) command SET_OBJECT_LIST to specify necessary 
libraries which are &oJ; quoted In text embedded directives* 

- Acquire any necessary libraries by either! 

o Creating the library file via the object library generator 

or 

o Staging the library file from real state to vitual state 

using the (HCS) command GET (with B56 conversion mode 

speci f i ed). 

- Stage the object text file from real state to virtual state 
using the (HCS) command GET (with B60 conversion mode 
specified)* 

- Convert the object text file from the CI data mapping to II data 
mapping by executing the HCS program CITQII* 

- Load and execute the program via the (HCS) command EXECUTE* 

- Stage the loadmap from virtual state to real state (for 

printing) by using either* 
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o The CHCS) cofmand REPLACE fwith A6 conversion mode 

specified) if running on the simulator* 
or 
o The <HC5) command JMRQUTE if running on the hardware* 

EXAMPLES 

The following is an example command sequence for executing a 
program not requiring any libraries for loadings 

Assumptions* all modules to be loaded are contained on the <real 
state) permanent file 'citxtrs'* 

SCL 

LINK_US£R,US£R«< j I n.NVE) .PASSWORD* j I nx. • . 
ACCOUNT*notused,PROJ£CT*notused 
HCS 

GET,cl txtvs,ci txtrs,,,NVE,B60 
EXECUTE, CITOI I, 'citxtvs.il text' 
EXECUTE, i i text, 'program parameters* 
JMROUTE, no tused,LOADMAP, PR, REMOTE 

The following is an example command sequence for executing a 
program requiring libraries for loading* 

Assumptions* the (real state) permanent file 'citxtrs' contains 
object text generated by the CY8IL CI compiler* The compiler 
modules reference procedures contained on the user library 'mylib* 
and the CYBIL run-time library* These libraries have been 
generated in virtual state and saved in real state* 

SCL 
LINK_USER,USER*(DEV1,DEV1F),PASSW0RD*DEV1X.* 

ACCOUNT»notused,PROJECT*notused 
LINKJJSER,USER«< j In, NVE), PASSWORD- jinx,.. 

ACCOUNT*notused,PROJ£CT»notused 
SET_OBJ£CT_LI$T,ADD»mylib 

SET_PROGRAM„OPTIONS,MAP_OPTIONS«(B,E,X,S) 
HCS 

GET,CYBILI8,CYBIILB,,,D£V1F,B56 
GETtml ib,myi ib,,,NVE,B56 
GEt,ci txtvs,ci txtrs,,,NVE, B60 
EX£CUTE»CITOII,*citxtvs,i itext* 
EXECUTE, i i text,' program parameters' 
JMRQUTE, no t used, LOADMAP, PR, REMOTE 
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£3.5.2.8.4 CYBIL RUNTIME 3 

The CYBIL runtime procedure can be obtained via the following! J 

GET.CYBILI8,CY8ILIB*.D£V1.NVE.B56 I 

£3.5.2.8.5 PERMANENT FILE PROGRAM INTERFACE BUILD J DEFICIFNCIFS 3 

1) Since no validation facility exists at build J* there is no 3 
official way for a 180 user's master catalog to be created. * 
Without a master catalog* it is impossible to use NOS/VE * 
permanent file requests aimed at **180 side* permanent fifes* It * 
is* however* possible for a 180 job to access 170 permanent 3 
files. If anyone requires access to **180 side" permanent files* ! 
a job can be provided that will create the required master ! 
catalog. * 

2) Permanent files on the *»180 side w are only permanent until a * 
NQS/VE deadstart. 3 

3) Usage - selections and shar e-requi ements may be specified on 3 
the ATTACH request but they will not be honored* Files will J 
never appear busy and hence the hold parameter has no affect on 3 
the ATTACH or GET requests. 5 

4) GET. SAVE and REPLACE are not completely implemented at build 5 
J. In their partial implementation* GET acts like an ATTACH 3 
(i.e*. no file copy occurs); SAVE acts like a DEFINE but 3 
requires that the local file already exist! REPLACE acts like a 3 
DEFINE but requies that the local file already exist and will 3 
replace the specified cycle if it already exists. This means * 
that a file that is already a permanent file Cvia DEFINE* SAVE 3 
or REPLACE) may not be saved or replaced. J 

5) Until build K it will not be possible to purge or replace a 3 
"180 side" permanent fie if it is attached by any job* including J 
the one doing the purge or replace. 3 

6) Permanent files are never purged because a retention period has * 
expired* 3 

7) Only cycle permission is required to replace a w 180 side" 3 
permanent f i I e. * 
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Type 
K.*8YEVE. 

€3,7 £S£I_IMES£HAIIOB 

To create an Express Deadstart Dump (EDD) tapes 

1) Mount scratch tape (ring in) on a 9-track drive, 

2) Push D#S button, 

3) Select U (utilities) display* 

4) Select E (EDD) display* 

5) Set channel (S2»12). 

6) Set ECUU (S2*01uu) 

E » equipment 

C * 1 for 67X drives 
2 for 66X drives 

uu '» unit number of the tape drive to be used* 

7) Answer **non zero inhibits rewind" with a CR* 

8) Answer "dump number" with a CR* 

9) Answer M CM/{M8) W with the size of memory you want to dump 
(in megabytes)* 

Notes This display may not appear* depending on the version 
of EDD being used* 

10) Answer "dump control war e M with a CR* 

To create a listing of the EDD tapes 

1) RE QUEST, DUMP. NT. D»PE.F*S.LB*KU. PO-R* VSN« your choice. 

2) GET.DSDI/UN*BRH* (On S/N 101*) 
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or 
GET,DSDf/UN*LIBRARY. (On S2.) 

3) Create DSDI directives file* 

A DSDI directive file should include the following: 

I0UMR. 

RROMR. 

MEMMR, 

PRORF, 

y*f i rst„by te_address* I as t_byte_adress*asi d. (where the 

f irs t_byte_address and I ast_byte_address are hex byte 

addresses and asid is the asid of the segment to be dumped) 

4) Execute DSDIs 

RFL.60G00* 

DSDI>M»D» I^input directives file*. 

5) To run (after the first time)* 
DSDI>I*n. 

(Does not read tape again*) 

6) To run interactively: 

Same as above* except to do W command must first do* 
OUTPUT. LISTFIl. 

7) C170 DSDI information can be found in Chapter 10 of the NOS 
SYSTEM MAINTENANCE Manual. 

A170 DSDI info can be found in document ARH3060 — GID for 
A170 N0S/S2. 

E3.8 aAfliAE-iHEflRflAIIQa 

Br ingi ng NAM up» 

1) To run NAMIAF* the 2550 in the northeast corner of the fishbowl 
is used, CLA f s 10* 11* 12 and 13 in the middle cabinet must be 
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turned off* and the CLA»s in the right hand cabinet must be 
on. The teletype beside the 2550 roust be OH and turned to 
LINE. 



2) At the system console enters 
FNC5,7700. 

2. NAM. 

3) If IAF is not up at control point 1* enters 

IAF. 

4) To send messages to ail terminals enter? 
2* C F 0* MS G* ALL* mess age. 

Bringing NAM down. 

1) At the system console* enters 
2.CF0.DI,NE. 

2) Turn the teletype by the 2550 off. 

3) To bring IAF down enters 
1.ST0P. 



E3.9 AUfi-HQLIilUiaQiiM 

Before leaving the machine* it is necessary to bring NOS down. 
If NOS has crashed* a level 3 deadstart must be attempted (see 
Section 3*1.8) even if the only reason is to bring NOS down. To 
bring NOS down* do the following! 

1) Enter: 

CHE 

The screen will display: 
CHECKPOINT SYSTEM. 
Enter: carriage return 

2) Make sure no mass storage device has a checkpoint rquested. To 
do this* enter: E*M. If the display shows there are no **C H s In 
the status field* then all devices are checkpointed and you may 
cont inue. 

3) Enters 
STEP. 
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4) Push deadstart button* « 

E 3 . 1 IHI£IIl!-B£llQEI^LIMll.iiaEM£-.BI]M£^Qmill£EAIIQM^ 5 

The foHojfing precautions must be taken when running dual state • 

with the Interim Memory Link storage move fix (NOS/VE Build 46 and t 

associated N0S/A170 System), \ 

1) Drop IRHF170, PASSON and all permanent file partner jobs before * 
doing *BY£VE. 2 

2) Do not rollout IRHF170, PASSON or permanent file partner jobs • 
at any time. i 

3) Before doing a CHECKPOINT SYSTEM, drop IRHF170, PASSON and all I 
permanent file partner jobs. « 

4) If the system crashes a N0S/A170 level 3 deadstart is the 5 
preferred action. If for some reason you must do an MCU 5 
recovery (REC command! do the following! ! 

- Clear word 17(8) via* 5 

99. % 

17,0. S 

- Enter REC on the MCU console. \ 

- Finish up in A170 only mode (i.e., do not do an UPMYVE), I 
then do a level 3 deadstart. If you bring up NOS/VE again i 
without doing a level 3 deadstart, the results are * 
unpredictable. I 

E 3 . 1 1 tiriS^t£.II4I£&ACUy£-£i£U.III-D£EfiAIiflll J 

E3.11.1 OPERATOR INITIATION i 

To bring up the NOS/VE interactive facility do the following: 

1) Bring up NOS/VE (build J7 or later). 

2) Bring up N0S/A170 networks? 

- FNC5,7700* (may sometimes be skipped) 
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- 2. NAM* 

3) Bring up A170 part of interactive* 

- X.PASSQN (CAT«nnn) 

Where nnn is (usually) the same catalog that was specified 
on the X.UPMYVE in step 1. 

4) When NOS/VE is upi bring up the C180 part of interactive* 

- K*EX IFEXECA. 

5) Bring up the remote host ( IRHF170,RHINPUT,RHQUT48) if desired. I 

E3*11.2 OPERATOR TERMINATION 

To terminate NOS/VE interactive any of the following may be 
donei 

- 2.CF0.DI* AP»TAF* C2 is the NAM control point number) 

This is the preferred method* To bring NOS/VE interactive back 
up; you must first do a 2.CF0.EN* AP*TAF. 

- 2.CFG.DI*N£. C2 is the NAM control point number) 
This terminates the entire network including IAF«RBF« etc* 

- N.DROP. (and) K*TMTERM If EXEC. (N is the PASSON control point 

number) 

E3*11.3 OTHER OPERATOR CAPABILITIES 

- To send a "shutdown warning" to ail terminals logged on to TAf 

do: 

2.CF0.ID* AP»TAF* (2 is the NAM control point number) 

- To send a message to all terminals do? 

2*CF0.MSG*All*mesage* <2 is the NAM control point number) 



S2 Machine Usage Document 



E3-23 
09/17/80 



£3*0 DUAL STATE NOS/VE DEADSTART 
£3.11*3 OTHER OPERATOR CAPABILITIES 



PASSON has the ability to record various types of diagnostic 
information* This capability is controlled via the sense 
switches at the PASSON control point* To turn a sense switch on 
(off) at control point N do: 

N*QNSWX. <N*0FFSWX*) 

Where X is the desired sense switch CI to 6>* The PASSON 

default is all sense switches off* It will take a short period 

of time before PASSON detects a change in a sense switch and 

reacts to it* The sense switches currently used by PASSON are* 



1 
2 
3 



Network Trace 

PASSON Logic Trace To Dayfile 

Memory Link Trace To Dayfile 



E3.11*4 INTERACTIVE TERMINAL OPERATION 



E 3 * 1 1 * 4 * l \L&lite£ism-ZsL~A£SL&zz„HQlll£ 



To access NOS/VE via the interactive facility* your user number 
must be validated to logon to the application named TAF* If you 
get the message •ILLEGAL APPLICATION 1 when trying to logon* you are 
probably not validated to access TAF* To correct this do the 
following from the console? 

X.MODVAL. 

K»N* (N is the MODVAL control point number) 

K.OVccc* (ccc is your user number) 

K*AP*ALL. 

K*£ND* 

K.END* 



If 



you get the message 'CONNECTION PROHIBITED* it means that 
~ »-~~~ J ~~i ««- ..«.*. number can be logged on to TAF at one 



only one terminal per user number can uc iwyycu v.* m i«r 
time* This indicates that someone has changed the network 
configuration - try a different user number until 1 " 1 "" ------ 

configuration is changed* 



the network 
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E 3.11.4. 2 UiliD-Ifl-MQIi^£ 

To initially login to NOS/VE via TAF* you must cause the first 
logon attempt to fail* This can be done by responding to the 
"FAMILY** logon prompt with something likes "A«A*A". This must be 
done because the system will try to connect the terminal to IAF on 
the first logon attempt no matter what is typed* To access TAF do 
the following on the second "FAMILY J" prompt! 

p user* pas sword* TAF 

You can access TAF from IAF by doing "HELL0*TAF" or by answering 
TAF to the system prompt "APPLICATIONS". 

When the terminal has been successfully logged in to NOS/VE* the 
following message will be displayed at the terminals 

Welcome to NOS/VE Interactive On The S2. 

e 3 . 1 1 . 4 * 3 lexiiual -U saas 

1) The slash (/) is a prompt to enter a NOS/VE command* Any * 
normal NOS/VE command can now be entered. The full ASCII I 
character set (lower or upper case and all special characters J 
can be used)* Commands do not need to be ended with a period* i 

2) A JMEXIT command will cause the NOS/VE Interactive Job to 5 
terminate and it's dayfile (job log) will be returned to the ! 
A170 for printing* A new NOS/VE Interactive Job can then be * 
started by responding to the •APPLICATIONS* prompt with TAF* 3 

3) A Terminal Break (Control T) can be used to discard output from ! 
a NOS/VE command. A Terminal Break will not terminate a NOS/VE * 
user task (i.e.* a task initiated with the EX command) or cause % 
it*s output to be discarded. An asynchronous (A parameter on I 
EX command) NOS/VE user task can be terminated with a TMTERM ! 
XXX command (XXX is the user task name as specified on the EX i 
command). A synchronous NOS/VE task or any NOS/VE task waiting I 
for input from the terminal cannot be terminated either by a I 
Terminal Break or a TMTERM command* * 

E 3 . 1 1 * 4 . 4 HQSZYE-EUUL ai_ A c.££££_Io._Iil£.-Ie.£miaal 5 

1) Interactive NOS/VE jobs are able to obtain terminal Input ' 
through the CLP$GET_STND_INP program Interface which can be % 
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E3*ll*4*4 NOS/VE Program Access To The Terminal 

used by both task services and user ring programs. Interactive 
programs which use this interface should be able to handle both 
upper and lower case input in order to make them more 
convenient to use in both 64 and 96 character set modes* 

2) Interactive NOS/VE jobs can send output to a terminal through 
the CiP$PUT_STND_OUT program interface which can be used by 
both task services and user ring programs* This interface will 
cause the terminal to operate in • no format effector 1 mode 
(i»e» pre and post print format effectors should not be used — 
each ClP$PUT_STND_OUT call will start a new line). 
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What we have established in the lab so far is the following! 

A 600 tape capacity tape rack for general use (located in near 
proximity to the 67X tape drives)* If your project would like 
to reserve a section of this tape rack* contact Tim or myself* 

A tape and disk cabinet for storage of system support materials 
which this project will manage and keep up to date* Clf you 
have been using this cabinet for unauthorized storage — 
beware* We have the key to the lock!) More will be published 
about the contents of this cabinet later* and a cabinet index 
will be posted in the lab to help locate where things are 
supposed to be placed within the cabinet* This cabinet is 
currently located against th East wall of the lab* is 6 ft* 8 
in* tall* gray in color and with sliding door* 

- A two-level documentation rack for system documentation 

listings* This contains the current build compilation listing 
interface deck compilation listing (from module named QLNGS)* 
listing of the NOS/VE PPU routines* system link map* and 
various assorted PVE listings* This rack is next to the tape 
and disk cabinet at this time* 

- A desk documentation rack for reference manuals and Tom McGee's 

collection of "how to** goodies* The objective is to have this 
reference information at arm f s length of the console* but it is 
currently on top of the two-level unit by the East wall. 

- At or near the console is a small notebook containing the NOS 

System Programmer's Instant* NOS Application Programmer's 
Instant* and the 180 Instruction codes* 

Feel free to examine and use all of the above materials while In 

the lab* Ofl_Biii-£JBmiilJE-fl£_^iiilS£-aB^-ilI-tJ}£i£-.malLSILlaISA-. Please 
notify Tim McGibbon or Mike Carter of any problems or deficiencies 
of these materials* Leave a note if we are not available* 
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1.0 Hardware Overview 

1.1 An introduction to CYBER 180 

1.2 C180 Instant 

1.3 Model Independent General Design Specification - ARH1700 

2.0 NOS Reference Manuals 

2.1 XEDIT V3.0 - 60455730 

2.2 IAF VI. C User's Guide - 60455260 

2.3 NOS Reference Manual - Vol 1, 60435400 - Vol 2, 60445300 

2.4 NOS Instant 

2.5 NOS Operators Guide - 60435600 

2.6 NOS Diagnostic Handbook 

2.7 NOS A170 ERS 

2.8 NOS A170 GID - ARH3060 

3.0 NQS/VE Reference Documents 

3.1 Program Interface ERS - obtained from Karen Rubey 

3.2 Command Interface ERS - obtained from Karen Rubey 

3.3 NQS/VE User's Guide - obtained by the following* 
ATTACH#HUG/UN*DAH 

SES. FORMAT I»HUG,L*L 1ST t LOCAL, TXTFORM 
SES. PRINT LIST 

3.4 NOS/VE Procedures and Conventions - obtained by 
SESjMAD.LISTPC 
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3.5 JFS Deadstart/180 Operating Procedures 

3.6 Listing of all NOS/VE Modules - obtained by 

SES* DEV1.LISTNVE. See Integration Procedures Notebook for 
deta i Is. 

3.7 Listing of all NOS/VE type declarations — obtained by 
doing* SES*DEV1.LISTNVE M*QLN0S. 

3.8 NOS/VE Code Tr ansmi ttal /PL Maintenance Procedures 
See Integration Procedures Notebook* 

3*9 NOS/VE Internal Interface Maintenance Procedures 

Memo available from S*C* Wood* 
3.10 Integration Procedures Notebook 

Obtained by? 

Acquire. IPND0C2/UN*MDC. SES. PRINT, IPND0C2. 

4,0 Tools Reference Documents 

4.1 PASCAL-X Interactive Debugger - ARH3142 

4.2 SES User's Guide - ARH1833 

4.3 PASCAL-X Specification ~ ARH2298 

4.4 C180 Assembler ERS - ARH1693 

4.5 Simulator ERS - ARH1729 

4.6 VEGEN ERS - ARH2591 

4.7 VELINK ERS - ARH2816 

4.8 Simulated I/O ERS - ARH3125 

4.9 Object Code Utilities ERS - ARH2922 

4.10 CYBIL Implementation Dependent Handbook - ARH3078 
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5»0 Duat State Cookbook 

To acquire additional copies of this document enters 

ACQUIRE D0CUM£N/UN*SKT512 
SES. FORMAT I-DOCUMEN TXTFORM. 
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The purpose of this document is to give an overview of the 
NOS/VE system {formerly called HCS) from the fol lowing 
perspectives 5 



Adding user tasks (tests) 

Modifying NOS/VE components 

Adding new NOS/VE components 

System usage - hardware and simulator 

Hi nts 
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?2. 0.1 INTRODUCTION J 

A user task can be defined as a group of modules linked • 

together that Mill execute in the *user ring 1 of NOS/VE* I 

currently ring 11. This task may make calls to any gated entries I 

within task services (rings 1 through 3) if the call bracket will * 

allow the call. Data defined within task services may not be I 

referenced from rings 4-15. * 

F2.0.2 USING THE VE LINKER 5 

The general format of the LINK command is* 

SES.VELINK LFL«CYBILIB LPF*LIBLCB 0FL*LGO NS»LIBX 

The LPF parameter specifies the file containing Virtual 
Environment Linker variables that control the linkage* If the 
LPF parameter is not specified* these variables default to values 
provided by the VELINK procedure. The values for both the LFL 
and OFL parameters may be anything the user requires - it is 
these parameter that define the makeup of a given user task. The 
VE Linker ERS should be consulted for a detailed description of 
the available parameters. 

Every LINK command creates one unique user task. The value 
for the NS parameter must be unique among all user tasks in a 
given virtual environment build. The value given must be 4 
characters and cannot be either MTRX or 3TSX* as these values are 
used for monitor and task services. 

The following example should help to clarify how to make the 
modifications. Suppose we want to create two user tasks. The 
first requires object files A and B from the current users 
catalog and file CC from catalog INT2. The second task requires 
object files D and E from the current catalog and library file 
LI* The necessary commands are* 

ACQUIRE.CC/UN-INT2 
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SES.VELINK LFL*CY8ILI8 LPF*LIBLCB QFL«{A#8*CC) NS-LIBX 
SES.VELINK LFL=CL1*CYBILIB) LPF*LIBLCB OFLMD.E) *. 
NS'LIBZ 

There are five things to note about this examples ! 

1) The use of multiple values with the LFL and OFi parameters Cup ! 
to 10). i 

2) The fact that local files are referenced first by the linker 
before they are searched for in the user's catalog* 

3) The use of a continuation {**) card* 

4) The unique NS values LIBX and LIBZ. ? 

5) The assumption that CYBILIB exists in the current catalog* or 1 
is already local to the job. If neither of these cases is true* I 
then CYBILIB must be ACQUIRED from the catalog which contains % 
the desired version* The same assumption holds for LI8LC8* % 

The changes to be to the VELDCM file are described below* * 
Immediately after the directives? 

LQADJOB STSX 

directives of the formats 

LQADLIB NS PNAME 

should be placed* There should be one directive per user task ! 
Ci*e*» one per user task LINK command in the VELDCM file)* The * 
NS parameter value must be the same as the value specified for 
the NS parameter on the LINK command. The value for PNAME may be 
any one to eight character name and is the name of this 'program* 
when it resides on the NOS/VE •library'. 

It is important to note that all code and data must fit into 
real memory at the time of loading and deadstart* The simulator 
imposes a 500K I16M with next release) byte restriction on 
maximum size and the hardware is restricted to 2M bytes* If the 
memory required exceeds the default maximum of 7A000 <16) bytes* 
then the VELDCM file must be changed to reflect this* The size 
of the page table must be increased so that it has 2 to V times 
as many entries as the number of real memory pages* The page 
table size is changed in the VfLDCN file in three different 
places* however* it is not just a simple substitution* 
Assistance should be obtained when any VELDCM file modifications 
are required* The following diagram shows the virtual 
environment after loadings 

memory 
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address > 0+ ♦ 

I Page Table t 

i Monitor * 

J Task ! 

J Services J 

1 Library J 

* Directory * 

J User \ 

J TasMs) 

\ (Library) \ 

Using the example from above* the two directives to be added * 
to the VELDCM file are: % 

LOADLIB LIBX PROGA 
LOADLIB LIBZ PROGB 

The names PROGA and PROGB can be whatever is desired* but must 
be unique within a single NOS/VE build. 

To execute PROGA* the following NOS/VE command is used* 

EXEC PROGA 'string* 

One final note about the VELDCM file* One of the last ! 

commands is a »DM ALL* command which produces a hex dump of the 5 
virtual environment file* This command may be removed if the 

dump is not wanted* * 

When using the VE Linker specifically to produce NOS/VE \ 

systems it is recommended that the procedure NOSLINK* as * 

described in the Advanced Systems Integration Procedures • 

Notebook* be used to produce these systems* Use of any other I 

procedures may lead to erroneous versions of interrelated * 

software components* * 



F3— 1 

NOS/VE USERS GUIDE 

09/17/80 



F3*0 EXECUTION 



F3*0 £1££UII£M 



F3.1 IfllfiflflULIIfll. 

NOS/VE will run on either the C180 hardware or the simulator* 
Any differences between the two are resolved by NOS/VE itself or 
by the procedures used to run it* 

NOS/VE provides three different types of commands. The first 
type allows access to most of the software facilities within the 
system* such as* 

Execution Management 
Logical Name Management 
Task Hanagement 
File Management 
Segment Management 
Memory Management 
Heap Management 
Signal Management 

The second type provides a debugging capability to be used 
within an executing task* The features available ares 

Breakpoint 

Trace Back 

Register Manipulation 

Memory Manipulation 

Both of the first two types are available on both the hardware 
and the simulator* The third type of command is available only 
on the hardware* These commands are processed by the PPU console 
driver* and offer the following features* 

Memory Manipulation 
Register Manipulation 
Print Memory 
OS Displays (Dayfile) 

NOS/VE currently supports a single job and multiple tasks 
within that job* A task may be executed synchronously or 
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asynchronously with other tasks* 

F3.2 Hflm£.£aflflAMI£ 

NOS/VE commands allow the user access to a large number of 
functions provided by the system* In general* any parameter to 
one of these commands may be either an explicit value or a 
logical name space <LNS) variable. One exception to this is the 
use of task status blocks or signal control blocks* which must 
always be LNS variables* A logical name space Is associated with 
a job* a fact which must be considered when running multiple 
tasks. 

The following types of LNS variables and parameters are 
avai lab! e: 

INTEGER 

CHARACTER 

NAME 

BOOLEAN 

VSTRING 

POINTER 

SIGNAL CONTROL BLOCK (temporary for HCS only) 

TASK STATUS BLOCKS 

Within the descriptions which follow* optional parameters are 
enclosed in square brackets ft 3). 

F3.2.1 DECLARE 

This command is used to create variables within the logical 
name space of the current job* 

Syntax! DECLARE NAME TYPE 

NAME - LNS variable name* 1 to 31 characters* 

TYPE — Variable type# must be one of the following: 

INTEGER - A 64 bit integer* 

BOOLEAN - The value TRUE or FALSE* 

POINTER - A pointer to cell. 

SCB - A signal control block* 

VSTRING - A STRING f*) variable. 
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CHARACTER - A .single character. 
TSB - A task status block. 



F3*2.2 REMOVE 

This command is used to remove a variable definition from the 
logical name space of the current job* 

Syntax? REMOVE NAME 

NAME - LNS variable name* 1 to 31 characters* 

F3.2.3 PFSTATS 



This command is used to display the following page fault 
statist! cs : 

avail q — Number of times a page was found in the 

aval 1 able queue* 
avail mod q — Number of times a page was found in the 

available/modified queue* 
valid in pt - Number of times the page was found in the page 

tab I e. 
no memory - Number of times a page fault could not be 

satisfied because no real memory was 

a v a i table* 
locked — Number of times a page fault could not be 

satisfied because the page frame was locked 110 

was active)* 
on disk — Number of times a page was found on a disk* 
pt full - Number of times a page fault could not be 

satisfied because an empty entry could not be 

found in the page table* 
cio reject — Number of times a page fault could not be 

satisfied because of an I/O error* 
new page - Number of times that a new page was created* 

syntax? PFSTATS 



NOS/VE USERS GUIDE 



F3-4 
09/17/80 



F3*0 EXECUTION 
F3.2*4 TSTATUS 



F3.2.4 TSTATUS 



This command is used to display the status of ail currently 
active tasks. The following information is displayed* 

Task Name 

Execution Time Used 
Number of page faults 

syntax* TSTATUS 



F3*2.5 THCYCLE 



This command causes a task to give up its turn for execution 
until all other ready tasks have had at least one chance to 
execute. 

syntax* THCYCLE 



F3.2.6 THOELAY 

This command causes a task to be kept from executing for a 
specified number of milliseconds. 

syntax* TMOELAY HS 

MS - Number of milliseconds to delay* 

F3.2.7 TMABORT 



This command causes the current task to be aborted* 
syntax* TMA80RT »HES* 
MES — A string to be displayed when the task is aborted* 
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F3.2.8 TMEXIT 

This command causes the current task to terminate normally 
syntax: TMEXIT 

F3.2.9 EXEC/EX 



This command causes a new task to 
subordinate to the current task. 

syntax: EXEC PROGRAM CPARAM3 CTSB3 
— or— 
EX PROGRAM CPARAM3 CTSB3 



>e created and executed 



PROGRAM - 



PARAM 



TSB 



The name of the program on the system 'library* to be 
executed. 



A string that is 
program header* 



passed to the program via the 



- One of the following: 

DEBUG - Specifies that the task is to be 

executed by the debug processor* 
The task is run synchronously. 

A - Specifies that the task should be 

executed asynchronously* but 
without any task status block 
being used. 

Other non-blank - Specifies that a task status 

block variable of the name given 
Is to be created in the current 
job's LNS and the new task is to 
be run asynchronously with the 
current task. The task name in 
this case will be the value given 
for this parameter. The user can 
determine the status of a task by 
printing the value of the task 
status block. 

If the parameter Is omitted* the task will be run 

synchronous! y. 
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F3*2*10 TMTERM 

This command is used to terminate a specific task and ail 
cat lees of that task* 

syntax? THTERM TASKNAME 

TASKNAHE - The name of the task to terminate. 

F3*2.11 SMOPEN 



This command causes a segment access open to be performed on a 
local file* or causes a transient segment to be created* 

syntax? SMOPEN PVA CNAME1 tSEGNUMl CR13 CR21 CATTR3 

PVA - The name of an INS pointer variable to receive the 
segment pointer. 

NAME — The name of the local file (1 to 8 characters) to open 
as a segment* If this parameter is omitted* a transient 
segment is created* 

SEGNUM- The segment number to be assigned to the segment. If 
this parameter is omitted* an unused segment number will 
be chosen* 

Rl - The Rl value for the segment* If this parameter is 
omitted* 11 is used* 

Rl - The R2 value for the segment* If this parameter is 
omitted* 11 is used* 

ATTR - The attributes of the segment* A legal value is any 
valid combination of the following letters? 

R - Read 

W - Write 

X - Execute 

B - Binding 

L — Execute Local Privilege 

G - Execute Global Privilege 

I - Wired 

K - Stack 

C — Cache Bypass 
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S ■— Shared 

Q - Sequential Access 

The default is RW» 
F3*2.12 SMCIOSE 



This command causes a segment of the current task to be 
removed from that task's address space* 

syntaxi SMCLOSE PVA 

PVA — A pointer to a celt. The segment represented by this 
pointer will be closed* 



F3.2*13 SMCHANGE 

This command allows some of a segments attributes to be 
changed after it has been created* 

syntax? SMCHANGE PVA CR13 [R23 IATTR3 

PVA - Same definition as SMOPEN 

RI - Same definition as SMOPEN 

R2 - Same definition as SMOPEN 

ATTR - Same definition as SMOPEN* 

F3.2*14 MMADVI 



This command causes the system to be notified that the 
specified range of virtual memory should be paged in as soon as 
poss ib 1 e. 

syntax* MMADVI CPVA3 CLEN3 

PVA — A pointer to the first byte of virtual memory to be paged 
in. The default is NIL* 

LEN - The number of bytes to page in* The default is 1* 
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F3.2,15 MJ1ADV0 

This command notifies the system that the specified range of 
virtual memory may be paged out (removed from the working set)» 

syntax: MMADVO CPVA1 CLEN1 

PVA - Same as in MMADVI* except that memory is paged out* 

LEN - Same as in HMADVI* except that memory is paged out* 

F3.2.16 MMADVOI 

This command performs the functions of both the MMADVQ and 
MMAOVI commands. The page out is performed first* 

syntax? MHAOVO CPVA03 CLENG1 CPVAI3 CLENI3 

PVAO - Same as in MMADVO. 

LENQ - Same as in MMADVO. 

PVAI - Same as in MMADVI. 

LENI - Same as in MMADVI. 

F3.2.17 nnm? 

This command is similar to the MMADVO command except that the 
pages are written to disk immediatiy* 

syntax? MMWMP CPVA1 CLEN1 IWAIT3 

PVA - Same as MMADVG. 

LEN - Same as MMADVO* 

WAIT - The value TRUE if the user desires to wait until all 
paging I/O is complete* otherwise FALSE* The default is 
TRUE. 
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F3*2.18 HMFREE 

This command causes the pages representing the specified range 
of virtual memory to be released* 

syntax* HilFREE PVA CLEN3 

PVA - same as in MMADVI. 

LEN - same as in MMADVI* 

F3.2.19 CONPVA 

This command converts a process virtual address <PVA) to a 
real memory address CRNA)* 

syntax? CQNPVA PVA CMQDE1 

PVA - The pointer to be converted to an RMA* 

MODE - One of the following values: 

DIRECT - The specified PVA is to be converted. This Is 
the default value, 

INDIR - The specified PVA is a pointer to the PVA to be 
converted. 

F3.2.20 HPINIT 

This command causes a heap to be created and initialized* 

syntax: HPINIT HEAPP LEN 

HEAPP - The name of an LNS pointer variable* It will be set to 
point to the heap* 

LEN - The length of the heap in bytes. 
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F3*2.21 HPALLOC 



This command allocates space within a previously created 
heap* 

syntax* HPALLOC PTR LEN CPAGECRQSl CZER01 HEAPP 

PTR - The name of an LNS pointer variable* It will be set to 
point to the allocated area* 



LEN 



- The number of bytes to allocate 



PAGECRGS- This parameter has no affect* It is included for 
compati bi I i ty* 

ZERO — The value TRUE if the allocated area is to be preset to 
the value zero or FALSE if it is to be left as is* 
The default is FALSE* 

HEAPP - A pointer to the heap in which the space is to be 
a I I oca ted* 



F3.2*22 HPFREE 



This command frees a block of space previously allocated from 
a heap* 

syntax: HPFREE PTR HEAPP 

PTR - The name of an LNS pointer variable which points to the 
block to be freed* 

HEAPP- A pointer to the heap in which the block is allocated* 



F3.2.23 SHINIT 



This command is used to initialize a signal control block* 

syntax: SHINIT SCB CTYPE3 CVSTR3 

SCB — The name of an LNS signal control block variable to be 
i ni tl al ized* 
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TYPE - The signal type to be associated with the SCB. Must be 
one of the following! 

EVENT 
SEME 
IORESP 
MESSAGE 

VSTR - If TYPE is message* then this parameter specifies a string 

variable whose size is the maximum message size allowed 

when using this SCB* and whose location is where the data 
will be pi aced. 



F3.2.24 SHSENO 



This command causes a send signal operation to be performed on 
the specified signal control block* 

syntax? SHSEND SCB CINT3 t*STR*1 

SCB - The LNS signal control block variable to which the signal 
is sent. 

INT - Integer value to be sent with the signal 

STR - A string (in quotes) to be sent as data along with the 
signal* If both INT and STR are specified* STR takes 
precedence. 



F3.2.25 SHWAIT 



This command causes the current task to wait until a specified 
amount of time has passed* or until any of up to three signals 
are sent. 



syntax* SHWAIT CITIME3 CSCB11 CSCB21 CSCB33 

ITIME- The number of mi 1 1 1 seconds to wait. If this parameter is 
omitted* infinity is used. 
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SCBi - Up to three INS signal control block variables to wait for 
a signal on* 



F3.2.26 CHANGE LNS VALUE 

This command allows the value of an LNS variable to be 
changed. Signal control block and task status block variables 
cannot be changed. 

syntax? LNSN * NV 

LNSN - The name of the LNS variable to be changed. 

NV - The new value. 

F3.2.27 PRINT LNS VALUE 

This command causes the value of an LNS variable to be 
disp layed. 

syntax? LNSN 

LNSN - The name of the LNS variable to be displayed. 

F3.2.28 ECHOINP 

This command causes all command input to NOS/VE to be echoed 
back to the output device. This command is useful only when used 
as the first command to a batch mode simulation. 

syntax! ECHOINP 
F3.2.29 STOPSIM 



This command causes NOS/VE to stop execution via a CPU halt 
when running on the simulator. 

syntax: STOPSIH 



F3-13 

NOS/VE USERS GUIDE 

09/17/80 



F3.0 EXECUTION 
F3.2.30 SSET 



F3.2.30 SSET 



This command allows some of the NOS/VE control parameters to 
be changed dynamically* 

syntax? SSET CPN CNV1 

CPN — The name of the control parameter being changed* The value 
must be one of the following Gentries followed by an * are 
not intended for general ' use) i ' 

QUANTUM - Basic task time slice (microseconds) for all 
tasks created after the execution of this 
command* 

MAXIDLE* - Maximum amount of time spent in monitor idle 
loop before looking for lost interrupts* 

TICKTIME*- Used for paging control* 

DFDELAY* - Minimum amount of time between the issuing of 
dayfile messages* Used to slow down the 
scrolling action of the console dayfile 
display* 

KEYMAX - Maximum value of the id field from a keypoint 
that will be placed in the keypoint buffer* 
Any keypoint with an id field greater than 
this value will be ignored* 

STEPCNT* -■ Maximum number of monitor requests allowed 
before monitor goes into wait loop* 

DBRING - Lowest ring that can be executed while In 
debug mode* 

PQTHRESH*- Number of pages kept in the page queues* 

KM - Keypoint mask used for every task created 
after execution of this command* 

MM - Monitor mask used for every task created 
after execution of this command* 

UM - User mask used for every task created after 
execution of this command* 
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PITVAL* - The value that the PIT is reset to after 
every PIT interrupt* 

DISDELAY - How often (milliseconds) the system status 
display (3 lines on the console) is updated* 

NV - The new value for the specified control parameter* If NV 
is omitted* the current value Mill be displayed* 

It is important to note that these commands are used primarily 
for hardware and monitor debugging and may change or disappear at 
any time* 



F3*2*31 FMCREATE 

This command makes a file known to the system* 

syntax? FMCREATE FILENAME 

FILENAME - The name of the file being created II to 8 
characters) • 

F3*2.32 FMDELETE 

This command deletes a file previously made known to the 
system with the FMCREATE command* 

syntax* FMDELETE FILENAME 

FILENAME - Name of tne file being deleted* 

F3.2.33 FMDOWNAU 

This command identifies bad areas on disk and keeps them from 
being a 1 located* 

syntax: FMDOWNAU UNIT CYLINDER TRACK SWLBUG SECTOR 

UNIT - Unit number of the disk device* 

CYLINDER - Cylinder number* 
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TRACK - Track number* 

SWIBUG - This parameter is present because of a compiler 

bug* 

SECTOR - Sector to be marked as bad within the specified 

unit/cylinder/track* 



F3.3 £QMQU-£I3iJMHI3S 

Commands to the system are entered via the console keyboard* 
With the exception of messages to the operating system* alt 
commands entered must include a two— character command identifier 
or a two-character operating system display identifier* Some 
commands require parameters* others do not* All command input 
lines are restricted to 60 characters or lessj all are terminated 
by depressing the carriage return key* 

F3.3*l DISPLAY CENTRAL HEMORY 

F3*3*l*l M$£l J*-:: J>a££i£j..Jl£4£ 

The following commands provide display of only the right-most 
60 bits of central memory words (they use the 60 bit PPU cm 
read/write instructions)* 

F3. 3*1*1*1 DP*<ADDRS> 

Displays an installation-specified number of central memory 
words; two words are displayed per display line along with the 
byte address of the left-most word of the line* 

<addrs>5 A 1-8 digit hexadecimal L&Ml-BZm&LX^hlXSi^aML&SS. which 
defines the first H££Ji to &e displayed* The specified 
address is forced to zero module eight if it is not so 
specified by the command* 

F3. 3.1.1. 2 DP.+ 

Increments the most recently specified memory address and 
displays a set of memory words which are contiguous with those 
most recently displayed. This command is used to *»roll w forward 

through memory* 
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F3.3. 1.1.3 DP,- 

Decrements the most recently specified memory address and 
displays a set of memory words which are contiguous with those 
most recently displayed* This command is used to **roll*» backward 
through memory. 

F3.3.1.1.4 DP 

This command may be used to reinstate the most recent central 
memory display after the screen has been used for other 
purposes* 

F 3* 3. 1.2 J2iS£l^-Z-£ull-J3fiilfi 

The following commands provide display of all 64 bits of 
central memory words* There are a number of characteristics of 
these commands of which the user should be aware: 

* These commands use the 64-bit central memory access 
mechani sm. 

F3*3. 1.2*1 DF.<ADDRS> 

Displays an installation-specified number of central memory 
words! two words are displayed per display line along with the 
byte address of the left-most word of the line. 

<addrs>* A 1-8 digit hexadecimal r ga 1 ^ffiftlQ r S .. ft Xte„ address which 
defines the first HSXiJ to be displayed* The specified 
address is forced to zero module eight if it is not so 
specified by the command* 

F3*3*1.2*2 DF,+ 

Increments the most recently specified memory address and 
displays a set of memory words which are contiguous with those 
most recently displayed* This command is used to "roll" forward 

through memory* 

F3. 3*1*2*3 DF,- 

Decrements the most recently specified memory address and 
displays a set of memory words which are contiguous with those 
most recently displayed* This command is used to *roll" backward 
through memory. 



F3-17 

NOS/VE USERS GUIDE 

09/17/80 



F3.0 EXECUTION 
F3. 3,1. 2.4 DF 



F3.3.1.2.4 DF 

This command may be used to reinstate the most recent central 
memory display after the screen has been used for other 
purposes* 

F3.3.2 CHANGE CENTRAL MEMORY 

f 3. 3. 2.1 £iiaaiie.r£3£iiJl-J!fii££ 

F3.3.2.1.1 CP*<ADDRS>*<VALU£> 

This command inserts a specified value Into the right-most 60 
bits of a 64-bit central memory word; the left— most 4 bits of the 
central memory word are unconditional I y set to zero* 

<addrs>* A 1-8 digit hexadecimal L&&L~B&mQ.LXJiLX£&-&&SiL££S. which 
defines the central memory w.oxsI which is to be 
modified. The specified address is forced to zero 
module eight if it is not so specified by the command, 

<value>s A 16 digit hexadecimal value which is to be inserted 
into the central memory word? all 16 digits must be 
specified. Blank characters may separate hex digits if 
desired to simplify value specification; for example* 
the two value specifications shown below yield the same 
resul t s 

valuel 0123456789ABCDEF 
value2 0123 4567 89AB CDEF 

F3.3.2.2 Q.hansi&zEulL-Msi& 

F3.3.2.2.1 CF»<ADDRS>»<VALUE> 

This command inserts a specified value into the full 64 bits 
of a 64-bit central memory word. 

<addrs>i A 1-8 digit hexadecimal L&al„m£.mQLX-kx£$.-a.&&L&S£. which 
defines the central memory moxj3 which Is to be 
modified. The specified address is forced to zero 
module eight if It is not so specified by the command. 

<value>J A 16 digit hexadecimal value which is to be inserted 
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Into the central memory word; all 16 digits must be 
specified. Blank characters may separate hex digits if 
desired to simplify value specification! for example* 
the two value specifications shown below yield the same 
resu I ts 

valuel G123456789ABCDEF 
value2 0123 4567 89A8 COEF 



F3.3.3 PRINT CENTRAL MEMORY 
F 3. 3* 3,1 ?n±£MMLZl±£&&ULzZ 

This command provides a listing of central memory to a line 
printer. Four words are fisted per line along with the byte 
address of the left-most word of the line. 

<addrs>: A 1-8 digit hexadecimal LSAl-m&M&LX„tllX&~MML&££ which 
defines the first central memory jjoxil to be listed* 
The specified address is forced to zero module eight if 
it is not so specified by the command* 

<words>s A 1-5 digit decimal value which specifies the number of 
central memory words to be listed* 

A listing operation may be terminated prior to its normal 
completion by depressing the carriage return at the keyboard* 

F3.3.4 DISPLAY/CHANGE SYSTEM ELEMENT REGISTERS 

F 3 • 3 * 4 • 1 M S£l A¥_£i.Sffl..£GJL.££ai£l£££ 

F3*3.4.1*l DR#<ELID> 

This command causes display of an installation defined set of 
registers of a system element* 

<elid>* A two-character system element identifier which 
specifies the element of which registers are to be 
displayed* Valid system element identifiers are listed 
under the section entitled "System Element 
Identif iers H * The registers displayed for each system 
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element are listed under the section entitled "System 
Element Registers**. 

F 3 . 3 * 4 * 2 £uaiIS£_£l£J£ai J*£Ili&t ££.£ 

F3* 3*4. 2.1 CR»<ELID>.<REGID>»<VALUE> 

This command permits modification of system element registers 
for which the maintenance channel has write access* 

<elid>2 A 2 character system element identifier which specifies 
the element of which a register is to be modified* 
Refer to the section entitled "System Element 
Identifiers** for a list j>f valid identifiers* 

<regid>? A 1-4 character regi ster t denti f i er which specifies the 
register which is to be modified* Refer to the section 
entitled "System Element Registers** for a list of valid 
register identifiers for each system element* 

<value>* A 16 digit hexadecimal value which is to be inserted 
into the register! all 16 digits must be specified* 
Blank characters may separate hex digits if desired* 

F 3 * 3 . 4 . 3 Iiil£ffl^£i£l eiii_Iii£BJtI£iexs 

Following is a list of valid system element identifiers* 

• M2 Identifies the central memory element 
« ft Identifies the central processor unit 

F 3 . 3 .4 . 4 S*S J^m-£l£ffl£n±_£ejii£iex£ 

The following subsections list* according to system element* 
those registers which may be displayed and which may be modified 
C assuming that the maintenance channel has write access to the 
specific register)* 

F3*3*4.4*l CENTRAL MEMORY REGISTERS 



F3-20 
NOS/VE USERS GUIDE 

09/17/80 



F3,Q EXECUTION 

F3.3.4.4.1 CENTRAL MEMORY REGISTERS 



REGISTER REGISTER NAME ACCESS 

MNEMONIC ATTRIBUTES 



SS Status Summary R 

EC Environment Control R/W 

BR Bounds Register R/W 

CELO Corrected Error log* Distributor R/W 

UC10 Uncorrected Error Log 1* Distributor R/W 

UC20 Uncorrected Error Log 2* Distributor R/W 

F3. 3. 4.4.2 CENTRAL PROCESSOR REGISTERS 

REGISTER REGISTER NAME 

MNEMONIC 



SS Status Summary 

EC Environment Control 

P Program Address 

MCR Monitor Condition Register 

UCR User Condition Register 

UP Untranslatable Pointer 

JPS Job Process State 

PES Processor Fault Status 

CEL1 Retry Corrected Error Log 

CEL2 Control Memory Corrected Error Log 

CEL3 Cache Corrected Error Log 

CEL4 Map Corrected Error Log 

KC Keypoint Code 

KCN Keypoint Class Number 

TE Trap Enables 

SIT System Interval Timer 

CMA Control Memory Address 

CMB Control Memory Breakpoint 

PTM Processor Test Mode 

MDW Model Dependent Word 

DEC Dependent Environment Control 

MSL Maintenance Scan Limit 



F3.3.5 DISPLAY PPS PROGRAM ADDRESS REGISTERS 



ACCESS 


ATTRIBUTES 


R 


R/W 


R/W 


R/W 


R/W 


R/W 


R/W 


R/W 


R/W 


R/W 


R/W 


R/W 


R/W 


R/W 


R/W 


R/W 


R/W 


R/W 


R/W 


R/W 


R/W 


R/W 
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F3*3*S*l ££ 

This command causes display of the program address register of 
each PPU in the PPS* 

F3*3*6 CLEAR DISPLAY 

F3*3.6.1 £Jl±£s.£L&SLnl 

This command is used to deactivate a currently active 
display* 

<screen>J Is L* R> or 8 to specify left screen* right screen* or 
both screens* respectively. 

F3.3.7 START SYSTEM 

F3*3*7*l ^ 

This command is used during system deadstart after the message 
"PROCEED** is displayed at the console; this command causes final 
initialization to occur and the CPU to be started* The command 
is valid at no other time* 

F3.3*8 HALT CENTRAL PROCESSOR 

F3*3*8.1 ijl 

This command is used to halt the central processor* 

F3*3*9 START CENTRAL PROCESSOR 
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F3.3.9.1 QQ 



This command is used to start the central processor after it 
has been halted with the HT command. 



F3.3.10 OPERATING SYSTEM DISPLAYS 

Various operating system displays are avail able to the 
console? a specific display may be called by typing its unique 
2-character identifier and a carriage return. 

F3. 3.10.1 fii5£lJi^«Iii£jaliIi££5^axuL.IlftS££iaiiaiLS 

DD - Dayfile of the system job. 
F3.3.11 CONSOLE MESSAGES TO THE OPERATING SYSTEM 



Single line messages of 60 characters or less may be sent to 

the operating system from the console keyboard. Any line of 

input from the keyboard is sent to the operating system if both 
of the following conditions are met* 

1. The first two characters of the line do not match a console 
command or an operating system display identifier. 

2. The number of characters In the Input line equals or exceeds 
1 character. 



F3.4 £££U£_£i£ILIII 

The debug facility of NOS/VE provides a set of capabilities 
intended to assist In testing of programs which execute under 
control of NOS/VE. Services provided by the facility are task 
oriented* selection of the debug facility is at the option of the 
user at the time of task invocation. NOS/VE uses the CYBER 180 
debug hardware to provide these capabilities. 
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F3.4*l SUMMARY OF DEBUG FACILITY SERVICES 

Set Breakpoints Selects a program interrupt which is to 

occur upon occurrence of a specified 
condition within a specified virtual 
address range. 

Remove Breakpoint: Deselects a previously selected program 

interrupt* 

Change Breakpoints Changes the virtual address range of a 

previously specified breakpoint* 

List Breakpoints Provides a list of currently selected 

breakpoints and associated conditions* 

Trace Backs Provides information relevant to stack 

frames associated with an interrupted 
procedure and its predecessor 
procedures* 

Display Stack Frames Display selected information from a 

specified stack frame* 

Display Registers Display the contents of a specified 

register of an interrupted procedure* 

Change Registers Sets a specified value into a specified 

register of an interrupted procedure* 

Display Memory* Displays the contents of a specified area 

of virtual memory* 

Change Memorys Sets a specified value into a specified 

location of virtual memory* 

Runs Invokes program execution after a 

selected program interrupt has occurred* 

F3.4.2 DEBUG FACILITY COMMANDS 
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F3*4.2*l £ J£ Affljfiifi£.HB£inI±ifln5 



<name> :?* 1-8 character breakpoint name 

<condition> ::* RgAOJ WRITE2RNI IBRANCHSCALL J DIVFLTJ ARLOSi 

AROVFUEXOVFUEXUNFUFPLOSJFPINDEFnNVBDP 
<base> JJa process virtual address 
<offset> i J« integer 
<length> ::* integer 
<frame> ::* 1**100 
<count> si* 1**100 
<regid> n« XUIP 
<regno> ::» 0. .155 0*.0FU6) 
<hex_vstr lng> n* 'hex string 1 
<time> *:« 1**<2**31)-1 
<vstring> ::» •charstring* 
<datatype> ss« HEXUSC II 5 ASC 5DECIHAUDEC 
<selector> h* FULL J AUTOS SAVE 



F3*4*2.2 £iuaiiaBilJifiifi£lB±Ijans 



Within the descriptions which follow* optional parameters are 
enclosed in brackets. Default values for optional parameters are 
also defined* 

F3*4. 2*2.1 SET BREAKPOINT 

Selects a program interrupt which is to occur upon occurrence 
of a specified condition within a specified virtual address 
range* 

syntax: BP <name> <condition> t<base>l t<offset>3 €<length>3 

The base parameter is required when specifying a new 
breakpoint name, offset and length specifications are optional In 
this case* When adding a new condition selection to an existing 
breakpoint* base* offset* and length parameters may not be 
specif i ed. 

Base* offset* and length parameters define the desired virtual 
address range: <base> ♦ <offset> yields a first-byte-address; 
first-byte-address ♦ <length> -1 yields a last byte address* 

Default parameter values: 

<offset>: 
<iength>: 1 
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F3.4.2.2.2 REMOVE BREAKPOINT 

Deselects a previously selected program Interrupt* 

syntax: RB <name> Kcondi tion>1 

If only the name parameter is specified* all conditions 
associated with the breakpoint are deselected and all evidence of 
the breakpoint is removed. If the condition parameter is 
specified* only that condition is deselected? however* if the 
specified condition is the only condition selected* all evidence 
of the named breakpoint Is removed. 

F3.4.2.2.3 LIST BREAKPOINT 

Provides a list of currently selected breakpoints and 
associated conditions. 

syntax? LB [<name>3 

If the name parameter is specified* information Is displayed 
for the named breakpoint only. If the name parameter is not 
specified* Information is displayed for all currently defined 
br eakpoi nts. 

F3.4.2.2.4 CHANGE BREAKPOINT 

Changes the virtual address range of a previously specified 

breakpoint. 

syntax? CB <name> <base> C<offset>3 t<length>1 

Base* offset* and length parameters define the desired virtual 
address ranges <base> ♦ <offset> yields a first-byte-address* 
first-byte-address ♦ <length> -1 yields a last byte address. 

Default parameter values? 

<offset>5 
<length>* 1 

F3.4.2.2.5 TRACE BACK 

Provides information relevant to stack frames associated with 
an interrupted procedure and its predecessor procedures. 

Information displayed for each selected stack frame consists 
of J 
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- Stack frame number! 

- Current P-address of the associated procedure? 

- Virtual address of the start of the stack frame? 

- Virtual address of the stack frame save area* 

syntax* TB [<frame>1 C<count>3 

The frame parameter specifies the number of the first stack 
frame for which information is to be displayed* (Stack frame 
number one is associated with the interrupted procedure* stack 
frame two is associated with the interrupted procedure's 
predecessor* etc*) 

The count parameter specifies the total number of stack frames 
for which information is to be displayed* 

Default parameter values* 

<frame>: 1 

<count>* 1 

F3*4*2.2.6 DISPLAY STACK FRAME 

Display selected information from a specified stack frame* 

syntax? DS [<frame>3 C<selector>3 

The frame parameter specifies the number of the stack frame 
for which information is to be displayed* {Stack frame number 
one is associated with the interrupted procedure* stack frame two 
Is associated with the interrupted procedure's predecessor* 
etc* ) 

The selector parameter identifies a region of the specified 
stack frames 






AUTO: Causes the automatic region of the stack frame to be 

displayed* S ^ ' 

1 9,0 , 

SAVE* Causes the save area of the stack frame to be n o ^ 

displayed* \ \-/ ~ 



FULL* Causes both the automatic and save areas of the stack 

frame to be displayed* / \ 

Default parameter values* 



v\ 
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<frarae>: 1 
<selector>s FULL 

F3*4*2*2*7 DISPLAY REGISTER 

Display the contents of a specified register of an interrupted 

procedure* 

syntax* DR <regid> £<regno>3 E<datatype>3 

Default parameter values? 

<regno>? 
<datatype>i HEX 

F3*4.2.2.8 CHANGE REGISTER 

Sets a specified value into a specified register of an 
interrupted procedure* 

syntax: CR <regid> <regno> [<datatype>3 <vstring> 

Default parameter values: 

<datatype>J Htt ^ C ) ' '' /"*'/ ft (T A 

F3*4*2*2*9 DISPLAY MEMORY 

Displays the contents of a specified area of virtual memory* 



syntax: DM <base> C<length>3 

V ,-r J , 

Default parameter values J ''"* v ' l " ' b ,;A «■-, '.^.^ ,.J 

I 
<length>: 8 (/ 

F3. 4. 2. 2*10 CHANGE MEMORY 

Sets a specified value into a specified location of virtual 

memory* 

4 
syntax: CM <base> <hex_vstr lng> 

F3*4. 2*2*11 RUN 

Invokes program execution after a selected program interrupt 
has occurred. 
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syntax? RUN <time> 

The time parameter specifies the maximum number of 
microseconds the program is to execute! a program interrupt will 
occur upon attaining this execution limit* 

Default parameter values? 

<time>? infinite 



F3.5 £££fl&-£Q12£S 

Error codes are displayed as 6 hex digits in the following 
format? 

AANNNN 

The AA field designates the functional area that issued the 
error* The possible values are? 

01 - Signal Handler 

02 - Circular Buffer Handler 

03 - Heap Manager 

04 - Misc Task Services 

05 - N/A 

06 - File Manager 

07 - N/A 

08 - Task Manager 

09 - Memory Manager 
OA - Job Manager 

OC - Loader 

OD - Central I/O 

OE - Dispatcher 

OF - Command Language Processor 

10 - Logical Name Manager 

11 - Debug Processor 

12 - Configuration Manager 



The NNNN field is a detailed error number within the specified 
f uncti onal area* 
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F3.5.I DETAILED ERROR CODES 

AH numeric values are given In hex» 
F 3 ,5. 1.1 SiaQJl-tUnilJUt 



1 * timeout 

2 * signal buffer full 

3 * task swapped 

4 * invalid signal id 

5 * Incompatible signal type 

6 s message buffer too small 

7 * empty wa i t list 

F 3 • 5 * 1 . 2 £i££Ula£_&iiH££-M£Hliiex 



1 * buffer not initialized 

2 « buffer ful 1 

3 * message too long 

F 3. 5 .1.3 hza2„$a&&&&L 



None 
F 3 . 5 » 1 • 4 MS£_£as!S-£££xL£££ 

None 
F 3 .5 ,1.5 Fj.le_ftan.auex 



1 ■ KFD not available 

2 * File acti ve 

3 * File not acti ve 

4 » PFD not available 

5 * File exi sts 

6 • ' Fi I e not created 

7 * File open 

8 * Mu 1 1 ip I e usage 

9 * File not temporary 
OA * File not permanent 
08 ■ File not attached 
OC « File attached 
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00 * File not open 

OE * Inval id KFDL index 

OF » KFD not active 

10 * Invalid PFDL Index 

11 * PFD not active 

12 * Active I/O 

13 * No units configured 
1$ * No active units 

F3.5.1.6 lazk^Maasi&L 



1 * Task not found 

F 3 • 5 • 1 * 7 UfiJILttrxJUflJLaeL 



1 * Page already in page table 

2 * Page table fuf I 

3 * No free pages 

4 * Locked page free request 

5 * Page not in page table 

6 * Invalid PVA 

7 * Page frame not locked 

8 * Page frame not assigned 

9 - IE » N/A 

IF * Invalid ring number 

20 * Segment table is full 

21 * Segment number is in use 

22 * Segment number not in use 

23 * Nil segment pointer invalid 

24 * Segment number too big 

25 * Cannot change segment number 

26 « Unsupported keyword 

F3.5.i»8 iafc.fiAQ.a&sr 



None 

F3.5.1.9 LfiJLd££ 

1 ■ program not found 
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F3.5.1.10 SL&ntLMl-LlQ 



1 « IGRP not available 

2 * En d of file 

3 * Invalid byte count 

4 « Invalid buffer length 

5 ■ Invalid buffer address 

6 * Invalid HS function code 

7 * Invalid CIO hardware type 

8 * Feature not supported 
9-40 « N/A 

41 - End of device 

42 * End of allocation 

43 * File not allocated 

44 * File already allocated 

45 » Invalid cylinder 

46 » Inval id track 

47 » Invalid sector 

48 * AUG not defined 

49 * AUO al I ocated 
4A - 80 * N/A 

81 * C80 not available 

F3*5.1,ll fiJL&BAtcJlfit 



1 a invalid task id 

2 * PTL full 

3 a invalid running job ordinal 

F3*5*l*12 £c;]B!aDd_Laafliiaii£-E£H££££aj: 



1 a missing parameter 

2 a invalid character 

3 a undefined parameter type 

4 a integer out of range 

5 a unknown command 

6 a unknown syntax 

7 a not supported 

8 a bad parameter type 

9 a token too long 

OA a bad combination of parameters 
OB a bad value for pointer 
OC a unknown parameter name 
OD a valid password required 
OE a SCB not event 
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F3. 5.l»l3 Lsi&LSt ai_Maia£_fiAn,aii£jr. 

1 * Entry not found 

2 * Type mismatch on put 

3 * Entry already exists 

4 * Illegal put request 

5 * Buffer wrong size 

6 * Buffer too smal I 

F3.5.1.14 fiL£jfcjj£_£jm££SSJl£ 

1 * Debug not Initialized 

2 * Breakpoint name exists 

3 * Base parameter not specified 

4 * Invalid breakpoint condition 

5 * Condition already selected 

6 * Maximum number of breakpoints already set 

7 * Invalid address range 

8 - Invalid breakpoint name 

9 * Condition not selected 
OA * No trap has occurred 

OB * Invalid stack frame specified 
OC * Register not in stack frame 

00 * Invalid data type definition 
OE ■ Invalid register type 

OF * Invalid P-reg value 

10 * Invalid A—reg value 

11 * Invalid X—reg value 

12 * Invalid selector 
3-OFE « N/A 

OFF * Unused error code 

f 3. 5. 1.15 CflnfJLflutaiiAD-lUnaflfi*. 

1 * Invalid function code 

2 * Not mass storage 

3 * Unit not active 

F 3. 5. 1.1 6 CEU-.EQMIIHE 

These values are stored in register XE just before NOS/VE halts 
the processors 

1 * Har dware f ai lure 
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2 » Task aborted in ring 1 or 2 

3 ■ Task aborted while abort in progress 

4 - Task executing had negative PIT 
301 * Hardware failure 
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F A • MfilHfi-£fll!W£JiIlflliS-i!lfl-SllU£££JlSAfi£ 



The conventions presented in this section reflect the current 
state of the NOS/VE system* formerly known as the Hardware 
Checkout System (HCS). The final NOS/VE system will differ from 
the current system in many ways* such as different functional 
areas* new functional areas* different naming conventions* etc» 
The conventions to be used in the final NOS/VE system are 
documented in the NOS/VE Project - Procedure and Conventions 
document. The information presented In this section is intended 
to assist users while HCS conventions are still in use* 

E4.1 HA&E1 

Ail global NOS/VE names have the following format* 

AATSNNN 

The AA field designates the functional area to which the name 
applies* and can be one of the following: 

SH - Signal Handler 

HP - Heap Manager 

FM - File Manager 

PM - Task Manager 

MM - Memory Manager 

JM - Job Manager 

it - Loader 

CI ~ Central I/O 

DS - Dispatcher 

CI - Command Language Processor 

LN - Logical Name Space Manager 

DB - Debug Processor 

CM - Configuration Manager 

OS - General NOS/VE 

MH - Machine Code Breakout 

DM - Data Management 

MT - Monitor Interrupt Processor 

The T field represents the type of the name* and can be one of 
the following values: 
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P - Procedure 

V - Variable 

£ - Error Constant 

K - Keypoint Constant 

The NNN field is a descriptive string describing the object* 

NOS/VE contains a routine that allows text Input to be 
performed easily* and without regard to whether execution is on 
the hardware or the simulator. When running on the simulator the 
system executes the 10 machine instruction topcode FFi which 
reads from the file specified on the I parameter when the 
simulator was called. When running on the hardware* text is 
input from the console* If more than one task attempts to read 
input at the same time when running on the simulator* the •first* 
task will get the data. If this happens on the hardware* any one 
of the tasks may get the data* 

The name of the routine is CLP$GET_5TND_INP and has the 
following declarations 

*call RCLGETS 

The variable cstring contains the input text and is defined as 
f ol I OWS5 

RECORD 

LHI.RHI : 0..255. 

S J STRING IZ55), 

RECENDJ 

The LHI field points to the leftmost character of the string* 
Any number of blanks may precede the first character of the 
string* A semicolon will be added as the last non blank 
character of the string and the RHI field will point to the 
semi col on* 

F4.3 I£lI_J3ilI£UI 

NOS/VE contains a routine that allows text output to be 
performed easily* and without regard to whether execution is on 
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the hardware or the simulator* When running on the simulator* 
the system executes the 10 machine instruction (opcode FF) which 
writes to the file specified on the parameter when the 
simulator was called* When running on the hardware* text Is 
output to the dayfile* which is scrolled on the console screen* 
If more than one task outputs to the console* the outputs Mill be 
intermixed* NOS/VE does not identify the output as to which task 
issued it* 

The name of the routine is CIP$PUT_STND_GUT and has the 
following declarations 

*call RCLPUTS 

Note that the string S is a VAR parameter* and as such* a 
literal string cannot be passed* 



F4.4 £Q£MMH_,UIILIII£S 

NOS/VE contains various routines that will aid in the process 
of command cracking* The user could read a line of text input 
via CLP$GET_STND_INP and then use these utilities to crack the 
command line* The following capabilities are available: 

CLP$CRACK_COHMAND - 

This routine uses a parameter descriptor table to crack the 
syntax of a command* A parameter value table is built specifying 
the actual values from the command* 

CLP$GET_TOKEN - 

This routine returns the next token from a command string. 

PHP$ASCII_TO_BINARY - 

This routine converts an ASCII string to a binary value* 

PMP$BINARY_TO_ASCII - 

This routine converts a binary number to its ASCII 
represen tati on* 

For more information on these routines* see a current source 
listing of them* 
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There are two ways to use these routines* One way would be to 
write a user task program which called on them directly* The 
second way is to modify the NOS/VE command language interface 
(routine CLP$J08_C0MMAND_PR0CESS0R) to process the desired 
commands* This second method might remove the nee6 for a user 
task program to aid in program checkout* 

NOS/VE provides a set of routines which externalize certain 
hardware instructions to a CYBIt program* These routines are 



described fully in a DAP written by Jack Steiner 
F4.5 £MfiRAHJd£AflER_fl£Sj^EUflii 



When a user task is executed via the EXEC command* the text 
string portion of the command is made available to the program* 
Also* the program can set the status return variable and have it 
displayed by the system at task termination* 

This communication is performed via the parameters of the 
PROGRAM statement* which has the following format* 

PROGRAM NAME CP * "STRING (255); 
SI s 0**4096; 
VAR STATUS : OSTSSTATUS); 

The P parameter points to the string specified on the EXEC 
command* and SL is the length of the string* For internal 
program calls* P can be declared as a "CELL and then any 
structure can be passed* 



F 4 . 6 IJ311Jlflll- fl££ILJl Aflilifi-£fllU££ilIIfltil 

The general format of a NOS/VE common deck name 1st: 

XAANNNN 

The X field denotes the type of deck and is one of the 
following: 

T - TYPE/CONST deck 

R - Procedure XREF deck 

The AA field denotes the functional area the deck deals with* 
The field may take on the same values as the AA field described 
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in section 5*1* 

Then NNNN field contains the first four characters of the name 
of the item the deck represents* For XREF's it is the first four 
characters from the descriptive part of the name* Ignoring the 
characters P$» # and ._* For a TYPE/CONST deck the value will be 
TYPE. For a TYPE/CONST deck defining tables the value Mill be 
TBLS* 

Some examples would be- 

Deck name rmcorapa from m#compare_swap* 

Deck name rclputs from name cl p$put_stnd_out* 

F4.7 Ill£JDRIA!iU£flailIULQ££ilS 

The following NOS/VE common decks are worthy of notes 

TOSTYPE - General OS definitions* 
THDWTYP - Hardware structure definitions* 
TMMTYPE - Memory management definitions* 
TSMTYPE - Segment management definitions* 
TCITYPE — Command language definitions* 

F4.8 J2££JLJUSAfi£ 

The following rules apply when using NOS/VE common decks* 

1) TYPE/CONST decks include all necessary keywords and end with a 

semicolon* 

2) Procedure XREF decks end with a semicolon* Other common decks 
may be required to define the types for the parameters 
speci ft ed* 

3) Variable XR£F decks do not contain the VAR keyword and end 
with a comma rather than a semicolon* Both the VAR keyword 
and ending semicolon must be supplied in the surrounding 
text* Other common decks may be required to define the type 
symbol • 
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F5.0 K£I£fllMIS 



Keypoints are used to give an execution time trace of program 
flow by showing that a given function is being performed fi.e** 
that a given procedure is being executed). Keypoints are also 
used to display request parameters* status and error conditions* 

F 5 • 1 SQii £££_££££ _£flHttEflIIQHS 

The general format of the source statement used to generate a 
keypoint from a CYBIL program is* 

#INLINE( 'KEYPOINT* ,S€CTION,0ATA*256t ID) J 

The SECTION parameter identifies the functional area that is 
issuing the keypoint. It must be in the range 1 to 15. The 
following values are currently defined? 

■ Denotes a continuation of data from the previous 

keypoint (the occurance of a trap may not allow this 
feature to work correctly)* 

1 * System information (ID numbers 1-63 are reserved for 

use by assembler code routines) (0SK$) 

2 * Memory Manager (MMK$) 

3 * Command Language (CLK$) 

4 * Debug (DBK$) 

5 * CIO (CIKS) 

6 * Fi 1e Manager tFMK$) 

7 * Task Services (TSK$) 

8 * Dispatcher CDSK$) 

9 * Unused 

10* Job Manager (JMK$) 
11* Signal Handler CSHK$) 
12* Loader CLLK$) 
13-15 * Unused 

The DATA parameter can be any 24 bit or less integer value* 
and is normally used to display data that relates to a particular 
keypoint. The value must be shifted left 8 bits (multiplied by 
256) so that it will not overlap with the ID value. 



NQS/VE USERS GUIDE 



F5-2 
09/17/80 



F5.0 KEYPOINTS 

F5*l SOURCE CODE CONVENTIONS 



The ID parameter Is used to identify the keypoint within a 
section* The value must be in the range to 255. Values less 
than 31 are considered critical* unexpected* unusual* etc* 

A user may add his own keypoints by using section 15 with 
appropriate DATA and ID values* 



F 5 . 2 H£I£Qli!lI-fiMA^USIM^IM£-.tiMfiMA££ 

A circular buffer of the last 200 keypoints is maintained in 
memory* These may foe displayed on the console using the 
following command* 

DM Creal memory address of the buffer> 

The buffer is defined by the symbol OSV$KEYPOINT_BUFFf R, which 
will appear in the LINKMAP where the monitor tables are defined* 
The real memory address is computed by adding the address of 
OSV$KEYPOINT_BUFFER to the length of the page table {monitor 
tables follow the page table)* 



Keypoints produced on the hardware are not nearly as useful 
simulator keypoints because only the last 200 are available 
they are displayed In ^n unedited format U*e.# a hex mem* 



as 
and 
lory 
dump)* However* they can be useful in showing the sequence of 
events leading up to a system crash* 



The format of the keypoint buffer is an array of words with 
each word having the following format* 

left 28 bits — Value of free running microsecond clock when the 

keypoint occured* 
Next 4 bits — Keypoint class 
Next 24 bits - Data value* 
Next 8 bits — Keypoint id value 

F 5 • 3 H£I£OIMI-JDAIA.USIMfi.Iti£«SIMLAia£ 

When executing on the simulator* all keypoint instructions 
cause an entry to be added to the local file SESSMKF* When 
execution is complete* this file may be processed by a utility 
program to produce a listing of the keypoint information in a 
readable format* 
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F5.3*l KEYPOINT REFORHATTING UTILITY 

The SESSMKF file produced by the simulator can be reformatted 
into a readable listing by executing the following procedure! 

X£Q*RN0SKEY£*B3tPR*tFNl} 

The 8 parameter* if present* causes the procedure to be run as 
a batch job* 

The FN parameter specifies the name of the file containing 
keypoint data. The default is SESSMKF* If this file is not a 
local file* or the procedure is running in batch mode* the file 
will be obtained from the current catalog* 

The PR parameter* if present* causes the reformatted listing 
to be sent to the printer* 

If run interactively* when the procedure terminates the 
reformatted listing is on local file KEYFILE* 

The RNQSKEY procedure requires two additional files as input. 
The first file defines how the keypoint information is to be 
reformatted. The name of this file is KEYDESC and St is obtained 
from the current catalog or* if not present there* from the 
NOS/VE catalog* The format of this file is described in section 
6*3.2. 

The second input file provides directives to the utility 
program which direct its execution* The following directives are 
supported* 

CV NAXPROCID N 

This directive causes ail keypoints with id values greater 
than N to be Ignored* 

CV UNDEFINED 

This command causes both defined and undefined keypoints to be 
printed. An undefined keypoint is one that does not have a 
definition in the KEYDESC file. 

CV DEFINED 

This command causes only defined keypoints to be printedm 
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CV I DENT 

This command causes the keypoint processor to indent the 
output produced based on the NS field of the KEYDESC file. 

RUN 

This command causes the processor to make one pass over the 
keypoint file. It is used after the CV commands have specified 
how to process the keypoint information* 

END 

This command terminates the keypoint processor* It must be 
the last command* 

These directives are read from file RNQSKEZ* This file is 
obtained from the current catalog or* if not found there* from 
the NQS/VE catalog* 



F5.3*2 KEYPOINT DESCRIPTION FILE 

The keypoint description file is used by the keypoint 

reformatting utility to direct the reformatting of the keypoint 

information* Each line in the file describes one keypoint* and 
has the following formats 

SID SCN PID LN F LEN FMT CSTR NS DT 

The SID field represents the section ID and is 2 characters 
long* An example would be HM for memory manager* 

The SCN field is the section class number* which equals the 
SECTION value from the keypoint instruction. 

The PID field is the procedure ID* which equals the ID value 

from the keypoint instruction* The SCN and PID values uniquely 

define a keypoint - all of the other information is used for 
reformatting* 

The LN field is used to cause a line on the keypoint listing 
to be preceeded by a * if the LN value is zero* This feature is 
used to mark a given keypoint as special* 

The F field specifies that this is a special keypoint fi*e«* 
has special meaning to the program that formats the keypoint 
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file)* The values must be one of the following! 

-Not spec ial 

1 - Task swi ten 

2 - Begin trap 

3 - End trap 

4 - Begin moni tor 

5 — End moni tor 

Any new keypoint descriptions should specify this field as 
zero unless the utility program is modified to handle the new 
value! s) * 

The LEN field specifies the length of the data portion of the 
keypoint in bytes. 

The FMT field specifies in what format the data portion of the 
keypoint should he displayed* and can be one of the foi lowing: 

H - Hex 

I - Integer 

A - ASCII 

The CSTR field i s a 1 to 8 character string describing the 
data portion of the keypoint. 

The NS field specifies the number of spaces to indent the DT 
string on the reformatted file. This feature can be used to show 
procedure nesting via keypoints. 

The DT field is a text string that describes the purpose of 
the keypoint. It may fill the rest of the current line. 

The user may add his own keypoint descriptions to this file 
and save it in his catalog. When RNQSKEY is run* the existing 
NOS/VE keypoints and user defined keypoints will be listed 
together. If the NOS/VE keypoints are not wanted* their 
descriptions may be deleted from the file. 

F5.3.3 REFORMATTED FILE DESCRIPTION 



The reformatted listing file contains two sections. The first 
is a summary of the number of times each keypoint occurred. The 
second section is a listing of all the keypoints in the order 
they were issued. Each line of the second section has the 

following formats 
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RT TSt DATA CSTR S TN SID DT 

The RT field designates the value of the free running 
microsecond clock (time since deadstart) when the keypoint was 
executed. On the simulator the clock is incremented by 1 for 
each instruction executed* 

The TSL field designates the time (microseconds) since the 
last keypoint instruction was executed* 

The DATA field specifies the value of the data portion of the 
keypoint in the format described in the keypoint description file 
for this keypoint. 

The CSTR field is the CSTR field from the keypoint description 
file for this keypoint* 

The S field specifies the state of the machine when the 
keypoint was issued and is one of the following} 

H - Monitor mode 
J - Job mode 

An * preceding the S field indicates that trap processing 
Is active* i*e#* the trap handler has been entered but 
not exited* 

The TN field gives the global task id of the task that was 
executing when the keypoint was issued* The system is task 1. 

The SID and DT fields are just the SID and DT fields from the 
keypoint description file for this keypoint. with the DT field 
indented as specified In the keypoint description* 
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F 6 . l iI4MG^Ali3I£«Q£4IlIIA£I.lMIIiJQilI-liQSX12I}l 

o Set the PPS deadstart panel as follows i 
(Note that this is not the setting for the IOU) 

lacaiiim S&JtJti&a Xn&tai£±JL£& 

1 7513 DCN 

2 2001 LDC 

3 0000 

4 7713 FNC 

5 0060 (Warmstart read: 556 bpl* 

un i t 0) 

6 7413 ACN 

7 7113 IAM 
10 6200 

o Set SWEEP/IOAD/DUHP switch on the PPS panel to LOAD position. 

o Mount deadstart tape on unit 0* 

o Verify that the 512 printer is READY. 

o Depress DEADSTART button at keyboard/display console < the 
message "PROCEED* should appear on the left screen). 

o Type SS (followed by a carriage return) to complete system 
initialization. 

F6.2 MAGSIAEI-MIIti-MMmfi 

This deadstart procedure uses the Common Test and 

Initialization <CTI) facility of NOS/170 to deadstart NOS/VE. It 

requires two tape units* one for the NOS/170 deadstart tape and 
one for the NOS/VE deadstart tape. 

Detailed information on the use of CTI is located in chapter 2 
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of the NOS Version 1 Operators Guide 160435600 J), 
o Set the deadstart panel as follows* 



£££±JJ2£} 


&£jtti: 


1 


0000 


2 


0000 


3 


0000 


4 


75TT 


5 


77TT 


6 


EODD 


7 


74TT 


10 


71TT 


11 


7301 


12 


RPXX 


13 


RPXX 


14 


0000 



TT is the channel number of the tape unit containing the 
NOS/170 deadstart tape. 

£ is the equipment number of the tape controller* 

1 ODD Is broken down as follows* 

FFU 

FF specifies the type of unit being deadstarted from and is 
12 for 67X tapes* 26 for 66X tapes and 3U for 844/885 
di sks. 

U (or UU) is the unit number of the device* 

Words 12 and 13 (RPXX) can be ignored as they are only used 
during NOS/170 deadstart. 

Mount the NOS/170 deadstart tape on the unit described by the 

deadstart panel settings* Mount the NOS/VE deadstart tape on 

another unit. Press the deadstart button. The CTI *A* 
display should appear. 

Select the U (utilities) option. The CTI *U* display should 
appear. 

Select the A (alternate deadstart) option. CTI will ask for 
the device type* channel* equipment and unit of the device to 
be deadstarted from. The values supplied by the user should 
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be the ones for the NOS/VE deadstart tape unit* 

o The message "PROCEED** should appear. Type **SS W to start 
NOS/VE, 
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F7.0 &rjm£-IS£I_££fl££AS£ 



NOS/VE has a set of programs which run as user tasks* These 
programs provide the following features? 

- checking specific hardware features* 

- checking specific NOS/VE software features. 

- creating a heavy and/or uniform load on the system* 

F 7 . 1 £*iSIIiaiL.I£SI_£AS£5 



F7*l.l SORT 

This program creates an array of records with random keys* 
then sorts this array and checks the results* 

The program allows a controlled amount of load to be applied 
to the system paging mechanism* 

syntax* EX SORT *NR.RS» 

NR - The number of records to be created and sorted* 

RS - A factor affecting the size of each record. By varying 
record size* the user can change the ratio of CP time to 10 
time for a test. The approximate record size is given by 
the formula* 

32+8*RS 

F7.1.2 USER1 

This program will display the line* 
•user task executing* 
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and then terminate* It is used to show that the system can at 
least execute a very small test case* 

syntax? EX AAAA "STRING* 

STRING - If this parameter is present* it will be output after 
the 'user task executing* message* 



F7.1.3 UUTL 

This program provides a variety of different test cases* and 
also allows them to be run in a repetitive manner. 

syntax? EX UUTL f STR« 

STR - A string describing which program to run and how to run 
it* The various programs are described below* 

F7*l.3.1 £MS£E£ 

This program generates an environment specification error* 
syntax: EX UUTL *ENVSPEC* 
F7*l*3.2 A&QXEL 

This program generates an arithmetic overflow error* 
syntax: EX UUTL •AROVFL 1 
F7*1.3.3 IJm£££ 

This program generates an instruction specification error* 
syntax: EX UUTL *INSSPEC* 
F7*1.3*4 UllLLI 

This program generates a divide fault error* 
syntax: EX UUTL »DIVFLT f 
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F7.1.3.5 LA 

This program performs an LA Uoad address) instruction on a 
specified PVA. It can be used to test various forms of memory 
protection* 

syntax? EX UUTL «LA»PVA« 

PVA - The virtual address to be loaded from. 

F7.1.3.6 $£ 

This program performs an SA <store address) instruction on a 
specified PVA. It can be used to test various forms of memory 
protection. 

syntax? EX UUTL 'SA#PVA» 

PVA - The virtual address to be stored into. 

F7.1.3.7 ££IliBM 

This program modifies the previous stack frame area and then 
returns to see what effect the modif lotion will have. 

syntax* EX UUTL »RETURN#N» 

N - Modification option. Must be one of the following* 

1 - Set value of A2 so it is not mod 8. 

2 - Set A2 bit 32 to 1. 

3 - Set A2 segment number invalid. 

4 - Set A3 segment number to segment without read access. 

5 - Set P register segment number invalid. 

6 — Set P register so it is not mod 2. 

7 - Set P register bit 32 to 1. 

8 - Set P register segment number to non executable 

segment. 

9 - Set final AO < > A2. 

10 - Cause VMID error. 

11 — Cause inward return. 

12 - Cause return to C170 mode. 
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F7*1.3.8 I£1I££S 

This program creates* writes and verifies an array of 

records* The record size is such that soie records will be 

located on a word boundary* some on all seven (other) byte 
boundaries* some Mill cross pages* etc* 

syntax: EX UUTL 'TESTMEM*BC« 

BC — Number of bytes to be allocated to the records* The number 
of records created is* BC DIV 17+1* 

F7.1.3.9 I£5IHM£ 

This program Is similar to TESTMEM* except that BOP 
instructions are used to compare and move records* 

syntax: ex UUTL *TESTMOVE*BC» 

BC - Number of bytes to be allocated to the records* The number 
of records created is* BC OIV 255*2 * 1* 

F7*i.3.10 £££i!£££ 



This program calls a procedure recursively* 
syntax: EX UUTL «R£CURSE*N» 

N - The number of times to recursively call the procedure* 
F7*1.3.11 £!£!£ 

This program cycles for a specified number of milliseconds 
It can be used to load the system with •idle tasks* 

syntax: EX UUTL 'CYCLE. MS» 

MS - The number of milliseconds to cycle for* 

F7.1*3.12 IIJi£IUiI 



This program delays for a specified amount of time In 
i ncr ements. 
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syntax? EX UUTL «TIME0UT#T1»T2* 

Tl — The number of milliseconds in each pmp$deiay request* 

T2 - The total number of mi I I i seconds delayed* 

F7.1*3.13 LQQl 

This program loops {executes) for a specified amount of time* 
It can be used to load the system with active tasks* 

syntax: EX UUTL •L0QP.J1S» 

MS - The number of milliseconds to execute for* 

F7.1.3.14 AUQ 

This program creates a segment with ready write* execute and 
binding attributes* places C170 code into it and executes that 
code* The code executed counts down an X register and when it 
gets to zero* executes an illegal C170 instruction lop code 
017BU 

syntax: EX UUTL »A170.N« 

N - This value times 1000000 is placed in the X register being 
decremented to zero* 

F7*1.3*15 ££££AI 

This program synchronously executes a program a given number 
of times* 

syntax: EX UUTL »REPEAT*PN.N* » STR»» 

PN - Name of the program to execute* It can be any program 
present in the NOS/VE library* 

N — The number of times to execute program PN* 

STR - The parameter string passed to the program when it begins 
execution* Note the use of double quote marks within a 
quoted string* 
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F7.0 NOS/VE TEST PROGRAMS 
F7*l*3*16 CALLER 



F7.1.3.16 £ili£E 

This program is similar to REPEAT* but the tasks are run 
asynchronous! y* 

syntax? EX UUTL 'CALLER* PN*N* • STR*» 

The parameter definitions are the same as REPEAT. 

F7. 1*3*17 SdlUL 



This program runs a number of different programs a specified 
number of times* This test is used primarily to load the system 
with a random mix of programs* Some programs will terminate 
abnormal I y* 

syntax? EX UUTL «8ULK*N*X* 

N — The number of times to execute the entire list* The 
foi lowing programs fwith parameters) are executed? 

LOOP, 5 

TIHE0UT*5 

CYCLE»5 

INSSPEC 

ADRSPEC 

ENVSPEC 

PRIVINS 

LA, 257800000000116) 

SA*100200000000C16) 

AROVFL 

X - If this parameter is specified Tany value except 1) then the 
test »iil be run asynchronously — that is* each test in the 
list will be started and after they are ail running* the BULK 
test will wait for them all to complete* This procedure is 
repeated N times* 

If this parameter is not specified* or is specified as 1* each 
test will be allowed to complete before the next test in the 
list is started* 
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F7*0 NOS/VE TEST PROGRAMS 
F7*l*3*18 BULKNTC 



F7*1.3.18 aiiUlM£ 

This program is similar to BULK* except that all of the 
programs run are expected to complete normally* 

syntaxs EX UUTL »BULKNTC.N#X» 

H - Same as for BULK* except the program list is the following: 

L00P#500 
L0GP*5 

TINE0UT,5,500 
CYCLE. 500 
RECURSE.5000 
LOOP, 10 

TESTHEM, 100000 
TESTMOVEf 100000 
LOOPtlOOO 

X - Same as for BULK, 

F7. 1.3*19 AJ}£SE££ 

This program causes an address specification error* 
syntax* EX UUTL *ADRSPEC» 
F 7. 1*3. 20 EEIIIMS 

This program causes a privileged instruction error* 
syntax* EX UUTL «PRIVINS» 



F7*2 £1AH£L££ 

To run the sort program on 1000 records of size 200 do J 

EX SORT • 1000.200* 
To run 53 asynchronous copies of same sort test do* 
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E7.0 NOS/VE TEST PROGRAMS 
F7»2 EXAMPLES 



EX UUTL "CALLER, SORT, 53, » 1000, 200* » 

To run the same sort test 45 times in succession, do 

EX UUTL 'REPEAT, SORT, 45, U0G0,200«» 

HINT* When running programs which may run for a long period of 
time, use the 'A 1 option on the EX command. This runs the 
programs asychr onousf y with the command processor. This 
allows you to status the test to see what is happening 
(TSTATUS, PESTATS) or to terminate the test if it runs too 
long <TMT£RH). 
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